@mbsks/rspfx-diagnostics 0.0.13 → 0.0.16

package/README.md

@@ -1,6 +1,6 @@
 # @mbsks/rspfx-diagnostics
 
-Diagnostics for [RSPFX](https://github.com/master8848/rspfx) — an SPFx-compatible build toolchain powered by Rspack.
+Diagnostics for [RSPFX](https://github.com/master8848/rspfx) — an SPFx-compatible build toolchain. Replaces Heft + webpack + gulp. Works with Vite, Rsbuild, and Rspack.
 
 Structured logging, typed errors, benchmarks, and formatting helpers shared across the toolchain and CLI.
 
@@ -40,5 +40,6 @@ console.log(formatBytes(1_500_000)); // "1.4 MB"
 
 ## Links
 
-- [RSPFX documentation](https://github.com/master8848/rspfx/tree/main/docs)
+- [Documentation](https://rspfx.mbsks.me) — [Getting Started](https://rspfx.mbsks.me/docs/getting-started)
+- [GitHub](https://github.com/master8848/rspfx)
 - License: MIT

package/dist/codes.d.ts

@@ -1,33 +1,41 @@
-export declare enum RspfxErrorCode {
-    ANALYZE_NO_DIST = "ANALYZE_NO_DIST",
-    BUILD_FAILED = "BUILD_FAILED",
-    CLEAN_NOT_A_PROJECT = "CLEAN_NOT_A_PROJECT",
-    COMPILE_ENTRY_NO_COMPONENT_ID = "COMPILE_ENTRY_NO_COMPONENT_ID",
-    COMPILE_ENTRY_NO_VERSION = "COMPILE_ENTRY_NO_VERSION",
-    COMPILE_FAILED = "COMPILE_FAILED",
-    COMPILE_NO_ENTRIES = "COMPILE_NO_ENTRIES",
-    CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND",
-    DEPLOY_FAILED = "DEPLOY_FAILED",
-    DEPLOY_INVALID_URL = "DEPLOY_INVALID_URL",
-    DEPLOY_TIMEOUT = "DEPLOY_TIMEOUT",
-    DEST_EXISTS = "DEST_EXISTS",
-    DEV_COMPILE_TIMEOUT = "DEV_COMPILE_TIMEOUT",
-    DUPLICATE_MANIFEST_ID = "DUPLICATE_MANIFEST_ID",
-    INSTALL_FAILED = "INSTALL_FAILED",
-    INVALID_MANIFEST_ID = "INVALID_MANIFEST_ID",
-    INVALID_MANIFEST_JSON = "INVALID_MANIFEST_JSON",
-    INVALID_OPTION = "INVALID_OPTION",
-    INVALID_PACKAGE_CONFIG = "INVALID_PACKAGE_CONFIG",
-    MISSING_ELEMENT_ASSET = "MISSING_ELEMENT_ASSET",
-    MULTIPLE_MANIFESTS = "MULTIPLE_MANIFESTS",
-    NO_MANIFESTS_FOUND = "NO_MANIFESTS_FOUND",
-    PLUGIN_NOT_FOUND = "PLUGIN_NOT_FOUND",
-    RSBUILD_BUILD_FAILED = "RSBUILD_BUILD_FAILED",
-    RSBUILD_NOT_FOUND = "RSBUILD_NOT_FOUND",
-    SPPKG_TRAVERSAL = "SPPKG_TRAVERSAL",
-    UNRESOLVED_EXTERNAL = "UNRESOLVED_EXTERNAL",
-    VITE_BUILD_FAILED = "VITE_BUILD_FAILED",
-    VITE_NOT_FOUND = "VITE_NOT_FOUND",
-    VITE_NO_ENTRY = "VITE_NO_ENTRY"
-}
+export declare const RspfxErrorCode: {
+    readonly AGGREGATE: "AGGREGATE";
+    readonly ANALYZE_NO_DIST: "ANALYZE_NO_DIST";
+    readonly BUILD_FAILED: "BUILD_FAILED";
+    readonly CLEAN_NOT_A_PROJECT: "CLEAN_NOT_A_PROJECT";
+    readonly COMPILE_ENTRY_NO_COMPONENT_ID: "COMPILE_ENTRY_NO_COMPONENT_ID";
+    readonly COMPILE_ENTRY_NO_VERSION: "COMPILE_ENTRY_NO_VERSION";
+    readonly COMPILE_FAILED: "COMPILE_FAILED";
+    readonly COMPILE_NO_ENTRIES: "COMPILE_NO_ENTRIES";
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_VALIDATION_FAILED: "CONFIG_VALIDATION_FAILED";
+    readonly DEPLOY_FAILED: "DEPLOY_FAILED";
+    readonly DEPLOY_INVALID_URL: "DEPLOY_INVALID_URL";
+    readonly DEPLOY_TIMEOUT: "DEPLOY_TIMEOUT";
+    readonly DEST_EXISTS: "DEST_EXISTS";
+    readonly DEV_COMPILE_TIMEOUT: "DEV_COMPILE_TIMEOUT";
+    readonly DUPLICATE_MANIFEST_ID: "DUPLICATE_MANIFEST_ID";
+    readonly HOOK_FAILED: "HOOK_FAILED";
+    readonly INSTALL_FAILED: "INSTALL_FAILED";
+    readonly INVALID_MANIFEST_ID: "INVALID_MANIFEST_ID";
+    readonly INVALID_MANIFEST_JSON: "INVALID_MANIFEST_JSON";
+    readonly INVALID_OPTION: "INVALID_OPTION";
+    readonly INVALID_PACKAGE_CONFIG: "INVALID_PACKAGE_CONFIG";
+    readonly MISSING_ELEMENT_ASSET: "MISSING_ELEMENT_ASSET";
+    readonly MULTIPLE_MANIFESTS: "MULTIPLE_MANIFESTS";
+    readonly NO_MANIFESTS_FOUND: "NO_MANIFESTS_FOUND";
+    readonly PACKAGE_VALIDATION: "PACKAGE_VALIDATION";
+    readonly PLUGIN_NOT_FOUND: "PLUGIN_NOT_FOUND";
+    readonly RSBUILD_BUILD_FAILED: "RSBUILD_BUILD_FAILED";
+    readonly RSBUILD_NOT_FOUND: "RSBUILD_NOT_FOUND";
+    readonly SPPKG_TRAVERSAL: "SPPKG_TRAVERSAL";
+    readonly UNRESOLVED_EXTERNAL: "UNRESOLVED_EXTERNAL";
+    readonly MIGRATE_BACKUP_EXISTS: "MIGRATE_BACKUP_EXISTS";
+    readonly VITE_BUILD_FAILED: "VITE_BUILD_FAILED";
+    readonly VITE_NOT_FOUND: "VITE_NOT_FOUND";
+    readonly VITE_NO_ENTRY: "VITE_NO_ENTRY";
+};
+export type RspfxErrorCode = (typeof RspfxErrorCode)[keyof typeof RspfxErrorCode] & {
+    readonly __brand: unique symbol;
+};
 //# sourceMappingURL=codes.d.ts.map

package/dist/codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,mBAAmB,wBAAwB;IAC3C,6BAA6B,kCAAkC;IAC/D,wBAAwB,6BAA6B;IACrD,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;IAC3B,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;IAC/C,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAC3C,qBAAqB,0BAA0B;IAC/C,cAAc,mBAAmB;IACjC,sBAAsB,2BAA2B;IACjD,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;CAChC"}
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,GAAG;IAClF,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAC;CACjC,CAAC"}

package/dist/codes.js

@@ -1,34 +1,38 @@
-export var RspfxErrorCode;
-(function (RspfxErrorCode) {
-    RspfxErrorCode["ANALYZE_NO_DIST"] = "ANALYZE_NO_DIST";
-    RspfxErrorCode["BUILD_FAILED"] = "BUILD_FAILED";
-    RspfxErrorCode["CLEAN_NOT_A_PROJECT"] = "CLEAN_NOT_A_PROJECT";
-    RspfxErrorCode["COMPILE_ENTRY_NO_COMPONENT_ID"] = "COMPILE_ENTRY_NO_COMPONENT_ID";
-    RspfxErrorCode["COMPILE_ENTRY_NO_VERSION"] = "COMPILE_ENTRY_NO_VERSION";
-    RspfxErrorCode["COMPILE_FAILED"] = "COMPILE_FAILED";
-    RspfxErrorCode["COMPILE_NO_ENTRIES"] = "COMPILE_NO_ENTRIES";
-    RspfxErrorCode["CONFIG_NOT_FOUND"] = "CONFIG_NOT_FOUND";
-    RspfxErrorCode["DEPLOY_FAILED"] = "DEPLOY_FAILED";
-    RspfxErrorCode["DEPLOY_INVALID_URL"] = "DEPLOY_INVALID_URL";
-    RspfxErrorCode["DEPLOY_TIMEOUT"] = "DEPLOY_TIMEOUT";
-    RspfxErrorCode["DEST_EXISTS"] = "DEST_EXISTS";
-    RspfxErrorCode["DEV_COMPILE_TIMEOUT"] = "DEV_COMPILE_TIMEOUT";
-    RspfxErrorCode["DUPLICATE_MANIFEST_ID"] = "DUPLICATE_MANIFEST_ID";
-    RspfxErrorCode["INSTALL_FAILED"] = "INSTALL_FAILED";
-    RspfxErrorCode["INVALID_MANIFEST_ID"] = "INVALID_MANIFEST_ID";
-    RspfxErrorCode["INVALID_MANIFEST_JSON"] = "INVALID_MANIFEST_JSON";
-    RspfxErrorCode["INVALID_OPTION"] = "INVALID_OPTION";
-    RspfxErrorCode["INVALID_PACKAGE_CONFIG"] = "INVALID_PACKAGE_CONFIG";
-    RspfxErrorCode["MISSING_ELEMENT_ASSET"] = "MISSING_ELEMENT_ASSET";
-    RspfxErrorCode["MULTIPLE_MANIFESTS"] = "MULTIPLE_MANIFESTS";
-    RspfxErrorCode["NO_MANIFESTS_FOUND"] = "NO_MANIFESTS_FOUND";
-    RspfxErrorCode["PLUGIN_NOT_FOUND"] = "PLUGIN_NOT_FOUND";
-    RspfxErrorCode["RSBUILD_BUILD_FAILED"] = "RSBUILD_BUILD_FAILED";
-    RspfxErrorCode["RSBUILD_NOT_FOUND"] = "RSBUILD_NOT_FOUND";
-    RspfxErrorCode["SPPKG_TRAVERSAL"] = "SPPKG_TRAVERSAL";
-    RspfxErrorCode["UNRESOLVED_EXTERNAL"] = "UNRESOLVED_EXTERNAL";
-    RspfxErrorCode["VITE_BUILD_FAILED"] = "VITE_BUILD_FAILED";
-    RspfxErrorCode["VITE_NOT_FOUND"] = "VITE_NOT_FOUND";
-    RspfxErrorCode["VITE_NO_ENTRY"] = "VITE_NO_ENTRY";
-})(RspfxErrorCode || (RspfxErrorCode = {}));
+export const RspfxErrorCode = {
+    AGGREGATE: 'AGGREGATE',
+    ANALYZE_NO_DIST: 'ANALYZE_NO_DIST',
+    BUILD_FAILED: 'BUILD_FAILED',
+    CLEAN_NOT_A_PROJECT: 'CLEAN_NOT_A_PROJECT',
+    COMPILE_ENTRY_NO_COMPONENT_ID: 'COMPILE_ENTRY_NO_COMPONENT_ID',
+    COMPILE_ENTRY_NO_VERSION: 'COMPILE_ENTRY_NO_VERSION',
+    COMPILE_FAILED: 'COMPILE_FAILED',
+    COMPILE_NO_ENTRIES: 'COMPILE_NO_ENTRIES',
+    CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',
+    CONFIG_VALIDATION_FAILED: 'CONFIG_VALIDATION_FAILED',
+    DEPLOY_FAILED: 'DEPLOY_FAILED',
+    DEPLOY_INVALID_URL: 'DEPLOY_INVALID_URL',
+    DEPLOY_TIMEOUT: 'DEPLOY_TIMEOUT',
+    DEST_EXISTS: 'DEST_EXISTS',
+    DEV_COMPILE_TIMEOUT: 'DEV_COMPILE_TIMEOUT',
+    DUPLICATE_MANIFEST_ID: 'DUPLICATE_MANIFEST_ID',
+    HOOK_FAILED: 'HOOK_FAILED',
+    INSTALL_FAILED: 'INSTALL_FAILED',
+    INVALID_MANIFEST_ID: 'INVALID_MANIFEST_ID',
+    INVALID_MANIFEST_JSON: 'INVALID_MANIFEST_JSON',
+    INVALID_OPTION: 'INVALID_OPTION',
+    INVALID_PACKAGE_CONFIG: 'INVALID_PACKAGE_CONFIG',
+    MISSING_ELEMENT_ASSET: 'MISSING_ELEMENT_ASSET',
+    MULTIPLE_MANIFESTS: 'MULTIPLE_MANIFESTS',
+    NO_MANIFESTS_FOUND: 'NO_MANIFESTS_FOUND',
+    PACKAGE_VALIDATION: 'PACKAGE_VALIDATION',
+    PLUGIN_NOT_FOUND: 'PLUGIN_NOT_FOUND',
+    RSBUILD_BUILD_FAILED: 'RSBUILD_BUILD_FAILED',
+    RSBUILD_NOT_FOUND: 'RSBUILD_NOT_FOUND',
+    SPPKG_TRAVERSAL: 'SPPKG_TRAVERSAL',
+    UNRESOLVED_EXTERNAL: 'UNRESOLVED_EXTERNAL',
+    MIGRATE_BACKUP_EXISTS: 'MIGRATE_BACKUP_EXISTS',
+    VITE_BUILD_FAILED: 'VITE_BUILD_FAILED',
+    VITE_NOT_FOUND: 'VITE_NOT_FOUND',
+    VITE_NO_ENTRY: 'VITE_NO_ENTRY'
+};
 //# sourceMappingURL=codes.js.map

package/dist/codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"codes.js","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cA+BX;AA/BD,WAAY,cAAc;IACxB,qDAAmC,CAAA;IACnC,+CAA6B,CAAA;IAC7B,6DAA2C,CAAA;IAC3C,iFAA+D,CAAA;IAC/D,uEAAqD,CAAA;IACrD,mDAAiC,CAAA;IACjC,2DAAyC,CAAA;IACzC,uDAAqC,CAAA;IACrC,iDAA+B,CAAA;IAC/B,2DAAyC,CAAA;IACzC,mDAAiC,CAAA;IACjC,6CAA2B,CAAA;IAC3B,6DAA2C,CAAA;IAC3C,iEAA+C,CAAA;IAC/C,mDAAiC,CAAA;IACjC,6DAA2C,CAAA;IAC3C,iEAA+C,CAAA;IAC/C,mDAAiC,CAAA;IACjC,mEAAiD,CAAA;IACjD,iEAA+C,CAAA;IAC/C,2DAAyC,CAAA;IACzC,2DAAyC,CAAA;IACzC,uDAAqC,CAAA;IACrC,+DAA6C,CAAA;IAC7C,yDAAuC,CAAA;IACvC,qDAAmC,CAAA;IACnC,6DAA2C,CAAA;IAC3C,yDAAuC,CAAA;IACvC,mDAAiC,CAAA;IACjC,iDAA+B,CAAA;AACjC,CAAC,EA/BW,cAAc,KAAd,cAAc,QA+BzB"}
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../src/codes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,WAAW;IACtB,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,6BAA6B,EAAE,+BAA+B;IAC9D,wBAAwB,EAAE,0BAA0B;IACpD,cAAc,EAAE,gBAAgB;IAChC,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,wBAAwB,EAAE,0BAA0B;IACpD,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,iBAAiB,EAAE,mBAAmB;IACtC,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAC1C,qBAAqB,EAAE,uBAAuB;IAC9C,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/error.d.ts

@@ -1,6 +1,18 @@
 export { RspfxErrorCode } from './codes.js';
+import { RspfxErrorCode } from './codes.js';
 export declare class RspfxError extends Error {
-    readonly code: string;
+    readonly code: RspfxErrorCode;
+    cause?: RspfxError | Error;
+    constructor(code: RspfxErrorCode, message: string, cause?: RspfxError | Error);
+    /** @deprecated use RspfxErrorCode constant */
     constructor(code: string, message: string, cause?: unknown);
 }
+export declare class AggregateRspfxError extends Error {
+    readonly code: RspfxErrorCode;
+    readonly errors: readonly RspfxError[];
+    constructor(errors: readonly RspfxError[], message?: string);
+}
+export declare function isRspfxError(e: unknown): e is RspfxError | AggregateRspfxError;
+export declare function isAggregateRspfxError(e: unknown): e is AggregateRspfxError;
+export declare function flatCauseChain(err: RspfxError): RspfxError[];
 //# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ3D"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;gBAEvB,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,KAAK;IAC7E,8CAA8C;gBAClC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAS3D;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAA+B,cAAc,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;gBAE3B,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,SAAiC;CAKpF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,GAAG,mBAAmB,CAE9E;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAE1E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,EAAE,CAsB5D"}

package/dist/error.js

@@ -1,4 +1,5 @@
 export { RspfxErrorCode } from './codes.js';
+import { RspfxErrorCode } from './codes.js';
 export class RspfxError extends Error {
     code;
     constructor(code, message, cause) {
@@ -10,4 +11,46 @@ export class RspfxError extends Error {
         }
     }
 }
+export class AggregateRspfxError extends Error {
+    code = RspfxErrorCode.AGGREGATE;
+    errors;
+    constructor(errors, message = `${errors.length} hook errors`) {
+        super(message);
+        this.name = 'AggregateRspfxError';
+        this.errors = errors;
+    }
+}
+export function isRspfxError(e) {
+    return e instanceof RspfxError || e instanceof AggregateRspfxError || (typeof e === 'object' && e !== null && 'code' in e);
+}
+export function isAggregateRspfxError(e) {
+    return e instanceof AggregateRspfxError;
+}
+export function flatCauseChain(err) {
+    const chain = [];
+    let current = err;
+    while (current) {
+        if (current instanceof RspfxError) {
+            chain.push(current);
+            current = current.cause;
+        }
+        else if (current instanceof Error && 'cause' in current && current.cause instanceof Error) {
+            const cause = current.cause;
+            if (cause instanceof RspfxError) {
+                chain.push(cause);
+                current = cause.cause;
+            }
+            else if (cause instanceof Error) {
+                current = cause;
+            }
+            else {
+                break;
+            }
+        }
+        else {
+            break;
+        }
+    }
+    return chain;
+}
 //# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAiB;IAM9B,YAAY,IAAY,EAAE,OAAe,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAsB,CAAC;QACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,IAAuC,CAAC,KAAK,GAAG,KAA2B,CAAC;QAC/E,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,cAAc,CAAC,SAA2B,CAAC;IAClD,MAAM,CAAwB;IAEvC,YAAY,MAA6B,EAAE,OAAO,GAAG,GAAG,MAAM,CAAC,MAAM,cAAc;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CAAC,YAAY,UAAU,IAAI,CAAC,YAAY,mBAAmB,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC;AAC7H,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,OAAO,CAAC,YAAY,mBAAmB,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAe;IAC5C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAmC,GAAG,CAAC;IAClD,OAAO,OAAO,EAAE,CAAC;QACf,IAAI,OAAO,YAAY,UAAU,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,KAAuC,CAAC;QAC5D,CAAC;aAAM,IAAI,OAAO,YAAY,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,YAAY,KAAK,EAAE,CAAC;YAC5F,MAAM,KAAK,GAAI,OAA+B,CAAC,KAAK,CAAC;YACrD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO,GAAI,KAAoB,CAAC,KAAuC,CAAC;YAC1E,CAAC;iBAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAClC,OAAO,GAAG,KAAK,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/format.d.ts

@@ -1,2 +1,6 @@
+import type { AggregateRspfxError, RspfxError } from './error.js';
 export declare function formatBytes(bytes: number): string;
+export declare function formatError(err: RspfxError | AggregateRspfxError, opts?: {
+    color?: boolean;
+}): string;
 //# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAMlE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,mBAAmB,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CA0CzG"}

package/dist/format.js

@@ -1,3 +1,5 @@
+import { isAggregateRspfxError } from './error.js';
+import { flatCauseChain } from './error.js';
 const UNITS = ['B', 'KiB', 'MiB', 'GiB', 'TiB'];
 export function formatBytes(bytes) {
     if (!Number.isFinite(bytes) || bytes < 0) {
@@ -14,4 +16,45 @@ export function formatBytes(bytes) {
     }
     return `${value.toFixed(1)} ${UNITS[unit]}`;
 }
+export function formatError(err, opts = {}) {
+    const useColor = opts.color ?? false;
+    const codeColor = useColor ? '\x1b[31m' : '';
+    const reset = useColor ? '\x1b[0m' : '';
+    const dim = useColor ? '\x1b[2m' : '';
+    if (isAggregateRspfxError(err)) {
+        const header = `${codeColor}[${err.code}]${reset} ${err.message}`;
+        const lines = [header];
+        err.errors.forEach((e, idx) => {
+            const prefix = `  ${idx + 1}. [${e.code}] ${e.message}`;
+            lines.push(useColor ? `${codeColor}${prefix}${reset}` : prefix);
+            const chain = flatCauseChain(e);
+            // chain already includes e as first element; show causes beyond first
+            for (let i = 1; i < chain.length; i++) {
+                const cause = chain[i];
+                lines.push(`${dim}     caused by [${cause.code}] ${cause.message}${reset}`);
+            }
+            if (e.cause && !(e.cause instanceof Error && 'code' in e.cause)) {
+                const msg = e.cause instanceof Error ? e.cause.message : String(e.cause);
+                lines.push(`${dim}     caused by ${msg}${reset}`);
+            }
+        });
+        return lines.join('\n');
+    }
+    const rspfx = err;
+    const base = `${codeColor}[${rspfx.code}]${reset} ${rspfx.message}`;
+    const chain = flatCauseChain(rspfx);
+    if (chain.length <= 1) {
+        if (rspfx.cause && !(rspfx.cause instanceof Error && 'code' in rspfx.cause)) {
+            const msg = rspfx.cause instanceof Error ? rspfx.cause.message : String(rspfx.cause);
+            return `${base}\n${dim}  caused by ${msg}${reset}`;
+        }
+        return base;
+    }
+    const lines = [base];
+    for (let i = 1; i < chain.length; i++) {
+        const cause = chain[i];
+        lines.push(`${dim}  caused by [${cause.code}] ${cause.message}${reset}`);
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAE,EAAE,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 export { reportBenchmark } from './benchmark.js';
-export { RspfxError } from './error.js';
+export { AggregateRspfxError, isAggregateRspfxError, isRspfxError, RspfxError, flatCauseChain } from './error.js';
 export { RspfxErrorCode } from './codes.js';
-export { formatBytes } from './format.js';
-export type { Logger, LogLevel } from './logger.js';
-export { createLogger } from './logger.js';
-export { timeStart, trace } from './trace.js';
+export type { RspfxErrorCode as RspfxErrorCodeType } from './codes.js';
+export { formatBytes, formatError } from './format.js';
+export type { Logger, LogLevel, LogFields, LogEntry, LoggerOptions } from './logger.js';
+export { createLogger, createDiagnosticFormatter } from './logger.js';
+export { timeStart, trace, createTracer } from './trace.js';
+export type { Tracer } from './trace.js';
+export type { HookResult, Issue, Result } from './result.js';
+export { andThen, err, map, ok, unwrap } from './result.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,7 +1,8 @@
 export { reportBenchmark } from './benchmark.js';
-export { RspfxError } from './error.js';
+export { AggregateRspfxError, isAggregateRspfxError, isRspfxError, RspfxError, flatCauseChain } from './error.js';
 export { RspfxErrorCode } from './codes.js';
-export { formatBytes } from './format.js';
-export { createLogger } from './logger.js';
-export { timeStart, trace } from './trace.js';
+export { formatBytes, formatError } from './format.js';
+export { createLogger, createDiagnosticFormatter } from './logger.js';
+export { timeStart, trace, createTracer } from './trace.js';
+export { andThen, err, map, ok, unwrap } from './result.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -1,10 +1,30 @@
-export type LogLevel = 'error' | 'warn' | 'info' | 'debug' | 'success';
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug' | 'success' | 'trace';
+export type LogFields = Record<string, string | number | boolean | undefined>;
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly name: string;
+    readonly message: string;
+    readonly fields: Readonly<LogFields>;
+    readonly timestamp: string;
+    readonly error?: unknown;
+}
+export interface LoggerOptions {
+    readonly level?: LogLevel;
+    readonly json?: boolean;
+    readonly sinks?: Array<(entry: LogEntry) => void>;
+}
 export interface Logger {
-    error(message: string): void;
-    warn(message: string): void;
-    info(message: string): void;
-    debug(message: string): void;
-    success(message: string): void;
+    readonly name: string;
+    error(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    debug(message: string, fields?: LogFields): void;
+    success(message: string, fields?: LogFields): void;
+    trace(message: string, fields?: LogFields): void;
+    child(fields: LogFields): Logger;
+    isLevelEnabled(level: LogLevel): boolean;
+    withLevel(level: LogLevel): Logger;
 }
-export declare function createLogger(name: string): Logger;
+export declare function createLogger(name: string, opts?: LoggerOptions): Logger;
+export declare function createDiagnosticFormatter(_logger: Logger): (err: import('./error.js').RspfxError | import('./error.js').AggregateRspfxError) => string;
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAiCD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAejD"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;AAE9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACnD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;CACpC;AA6FD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,MAAM,CAKvE;AAID,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,YAAY,EAAE,UAAU,GAAG,OAAO,YAAY,EAAE,mBAAmB,KAAK,MAAM,CAMtJ"}

package/dist/logger.js

@@ -4,40 +4,97 @@ const COLORS = {
     warn: '\x1b[33m',
     info: '\x1b[36m',
     debug: '\x1b[2m',
-    success: '\x1b[32m'
+    success: '\x1b[32m',
+    trace: '\x1b[2m'
 };
 const RANKS = {
     error: 0,
     warn: 1,
     info: 2,
     success: 2,
-    debug: 3
+    debug: 3,
+    trace: 4
 };
-function configuredLevel() {
-    switch (process.env.RSPFX_LOG_LEVEL) {
-        case 'error':
-            return 0;
-        case 'warn':
-            return 1;
-        case 'debug':
-            return 3;
-        default:
-            return 2;
-    }
+function parseLevel(raw) {
+    if (!raw)
+        return undefined;
+    const v = raw.toLowerCase();
+    if (v in RANKS)
+        return v;
+    return undefined;
+}
+function resolveLevel(opts) {
+    if (opts?.level && opts.level in RANKS)
+        return RANKS[opts.level];
+    const env = parseLevel(process.env.RSPFX_LOG_LEVEL);
+    if (env)
+        return RANKS[env];
+    return RANKS.info;
+}
+function isJsonEnabled(opts) {
+    if (opts?.json !== undefined)
+        return opts.json;
+    return process.env.RSPFX_LOG_JSON === '1';
 }
-export function createLogger(name) {
-    function write(level, stream, message) {
-        if (RANKS[level] > configuredLevel()) {
+function buildLogger(name, opts, parentFields, levelRank, json, sinks) {
+    function shouldLog(level) {
+        return RANKS[level] <= levelRank;
+    }
+    function emit(level, message, fields) {
+        if (!shouldLog(level))
+            return;
+        const merged = { ...parentFields, ...(fields ?? {}) };
+        const timestamp = new Date().toISOString();
+        const entry = { level, name, message, fields: merged, timestamp };
+        if (sinks && sinks.length > 0) {
+            for (const sink of sinks)
+                sink(entry);
             return;
         }
-        stream.write(`${COLORS[level]}[${name}] ${level}: ${message}${RESET}\n`);
+        if (json) {
+            const line = JSON.stringify({ level, name, message, fields: merged, timestamp });
+            process.stdout.write(line + '\n');
+            return;
+        }
+        const fieldStr = Object.keys(merged).length > 0 ? ` ${Object.entries(merged).map(([k, v]) => `${k}=${String(v)}`).join(' ')}` : '';
+        const stream = level === 'error' || level === 'warn' ? process.stderr : process.stdout;
+        stream.write(`${COLORS[level]}[${name}] ${level}: ${message}${fieldStr}${RESET}\n`);
     }
-    return {
-        error: (message) => write('error', process.stderr, message),
-        warn: (message) => write('warn', process.stderr, message),
-        info: (message) => write('info', process.stdout, message),
-        debug: (message) => write('debug', process.stdout, message),
-        success: (message) => write('success', process.stdout, message)
+    const logger = {
+        name,
+        error: (m, f) => emit('error', m, f),
+        warn: (m, f) => emit('warn', m, f),
+        info: (m, f) => emit('info', m, f),
+        debug: (m, f) => emit('debug', m, f),
+        success: (m, f) => emit('success', m, f),
+        trace: (m, f) => emit('trace', m, f),
+        isLevelEnabled: (l) => shouldLog(l),
+        withLevel: (l) => {
+            const newRank = RANKS[l];
+            const newJson = opts?.json ?? process.env.RSPFX_LOG_JSON === '1';
+            const newSinks = opts?.sinks ? [...opts.sinks] : undefined;
+            // withLevel should not carry parentFields; it creates a fresh logger with same name and new level, but if called on child, should preserve parentFields
+            return buildLogger(name, { ...opts, level: l, json: newJson, sinks: newSinks }, parentFields, newRank, newJson, newSinks);
+        },
+        child: (extra) => {
+            const mergedParent = { ...parentFields, ...extra };
+            return buildLogger(name, opts, mergedParent, levelRank, json, sinks);
+        }
+    };
+    return logger;
+}
+export function createLogger(name, opts) {
+    const levelRank = resolveLevel(opts);
+    const json = isJsonEnabled(opts);
+    const sinks = opts?.sinks ? [...opts.sinks] : undefined;
+    return buildLogger(name, opts, {}, levelRank, json, sinks);
+}
+import { formatError } from './format.js';
+export function createDiagnosticFormatter(_logger) {
+    return (err) => {
+        const json = process.env.RSPFX_LOG_JSON === '1';
+        const useColor = !json && process.stdout.isTTY !== false;
+        return formatError(err, { color: useColor });
     };
 }
 //# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAUA,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,UAAU;CACpB,CAAC;AAEF,MAAM,KAAK,GAA6B;IACtC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,eAAe;IACtB,QAAQ,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;QACX,KAAK,OAAO;YACV,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,SAAS,KAAK,CAAC,KAAe,EAAE,MAA0B,EAAE,OAAe;QACzE,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,eAAe,EAAE,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,KAAK,KAAK,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;QACzD,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;QACzD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3D,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/result.d.ts

@@ -0,0 +1,20 @@
+import type { RspfxErrorCode } from './codes.js';
+export type Result<T, E> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+export declare function ok<T>(value: T): Result<T, never>;
+export declare function err<E>(error: E): Result<never, E>;
+export declare function map<T, U, E>(r: Result<T, E>, fn: (t: T) => U): Result<U, E>;
+export declare function andThen<T, U, E>(r: Result<T, E>, fn: (t: T) => Result<U, E>): Result<U, E>;
+export declare function unwrap<T, E>(r: Result<T, E>): T;
+export type Issue = {
+    path: (string | number)[];
+    message: string;
+    code: RspfxErrorCode;
+};
+export type HookResult<T> = Result<T, import('./error.js').RspfxError | import('./error.js').AggregateRspfxError>;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAE5E,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEhD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAEjD;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE3E;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAE1F;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAG/C;AAED,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzF,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,OAAO,YAAY,EAAE,UAAU,GAAG,OAAO,YAAY,EAAE,mBAAmB,CAAC,CAAC"}

package/dist/result.js

@@ -0,0 +1,18 @@
+export function ok(value) {
+    return { ok: true, value };
+}
+export function err(error) {
+    return { ok: false, error };
+}
+export function map(r, fn) {
+    return r.ok ? ok(fn(r.value)) : r;
+}
+export function andThen(r, fn) {
+    return r.ok ? fn(r.value) : r;
+}
+export function unwrap(r) {
+    if (r.ok)
+        return r.value;
+    throw r.error;
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,GAAG,CAAU,CAAe,EAAE,EAAe;IAC3D,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,OAAO,CAAU,CAAe,EAAE,EAA0B;IAC1E,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,MAAM,CAAO,CAAe;IAC1C,IAAI,CAAC,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IACzB,MAAM,CAAC,CAAC,KAAK,CAAC;AAChB,CAAC"}

package/dist/trace.d.ts

@@ -1,3 +1,9 @@
-export declare function timeStart(name: string): () => number;
+import type { Logger } from './logger.js';
+export declare function timeStart(_name: string): () => number;
 export declare function trace<T>(name: string, fn: () => Promise<T>): Promise<T>;
+export interface Tracer {
+    span<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    time<T>(name: string, fn: () => T): T;
+}
+export declare function createTracer(logger: Logger): Tracer;
 //# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CAGpD;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAS7E"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,MAAM,CAGrD;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAa7E;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACvC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+CnD"}

package/dist/trace.js

@@ -1,7 +1,5 @@
-import { createLogger } from './logger.js';
 import { reportBenchmark } from './benchmark.js';
-const logger = createLogger('trace');
-export function timeStart(name) {
+export function timeStart(_name) {
     const start = performance.now();
     return () => performance.now() - start;
 }
@@ -12,8 +10,66 @@ export async function trace(name, fn) {
     }
     finally {
         const ms = elapsed();
+        // Use a transient logger; trace already has debug sink
+        // Import lazily to avoid circular
+        const { createLogger } = await import('./logger.js');
+        const logger = createLogger('trace');
         logger.debug(`${name}: ${ms.toFixed(1)}ms`);
         reportBenchmark(name, ms);
     }
 }
+export function createTracer(logger) {
+    return {
+        async span(name, fn) {
+            if (!logger.isLevelEnabled('trace')) {
+                const start = performance.now();
+                try {
+                    return await fn();
+                }
+                finally {
+                    const durationMs = performance.now() - start;
+                    // even if not trace-enabled, report benchmark for internal telemetry? Spec says trace logs only when enabled.
+                    // We still report benchmark if needed? No, only log when enabled.
+                    // To keep behavior, only log when trace enabled; benchmark reported regardless via reportBenchmark.
+                    reportBenchmark(name, durationMs);
+                }
+            }
+            const start = performance.now();
+            logger.trace(`enter ${name}`);
+            try {
+                const result = await fn();
+                const durationMs = performance.now() - start;
+                logger.trace(`exit ${name}`, { durationMs });
+                reportBenchmark(name, durationMs);
+                return result;
+            }
+            catch (e) {
+                const durationMs = performance.now() - start;
+                logger.trace(`error ${name}`, { durationMs });
+                reportBenchmark(name, durationMs);
+                throw e;
+            }
+        },
+        time(name, fn) {
+            const start = performance.now();
+            if (logger.isLevelEnabled('trace'))
+                logger.trace(`enter ${name}`);
+            try {
+                const result = fn();
+                const durationMs = performance.now() - start;
+                if (logger.isLevelEnabled('trace'))
+                    logger.trace(`exit ${name}`, { durationMs });
+                reportBenchmark(name, durationMs);
+                return result;
+            }
+            catch (e) {
+                const durationMs = performance.now() - start;
+                if (logger.isLevelEnabled('trace'))
+                    logger.trace(`error ${name}`, { durationMs });
+                reportBenchmark(name, durationMs);
+                throw e;
+            }
+        }
+    };
+}
 //# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAErC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,IAAY,EAAE,EAAoB;IAC/D,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5C,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbsks/rspfx-diagnostics",
-  "version": "0.0.13",
+  "version": "0.0.16",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,17 +16,17 @@
     "dist"
   ],
   "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
   "dependencies": {
-    "@mbsks/rspfx-core": "0.0.13"
+    "@mbsks/rspfx-core": "0.0.14"
   },
   "description": "RSPFX diagnostics: logger, typed errors, benchmarks, formatting",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/master8848/rspfx.git"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 RSPFX contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.