@mediaproc/core 1.3.0 → 1.5.0

package/dist/errors/errorTypes.d.ts

@@ -1,33 +1,83 @@
 export declare enum ErrorType {
     UserInput = "UserInput",
+    Validation = "Validation",
+    Config = "Config",
+    Unsupported = "Unsupported",
+    NotImplemented = "NotImplemented",
     FileSystem = "FileSystem",
     Tool = "Tool",
-    Unsupported = "Unsupported",
+    Dependency = "Dependency",
     Plugin = "Plugin",
-    Internal = "Internal"
+    Internal = "Internal",
+    Cancelled = "Cancelled"
+}
+export declare enum ErrorSeverity {
+    Info = "Info",
+    Warning = "Warning",
+    Error = "Error",
+    Fatal = "Fatal"
+}
+export declare enum ErrorSource {
+    User = "User",
+    MediaProc = "MediaProc",
+    Plugin = "Plugin",
+    ExternalTool = "ExternalTool",
+    System = "System"
 }
 export declare class MediaProcError extends Error {
-    type: ErrorType;
-    exitCode: number;
-    details?: any;
-    constructor(message: string, type: ErrorType, exitCode: number, details?: any);
+    readonly type: ErrorType;
+    readonly exitCode: number;
+    readonly severity: ErrorSeverity;
+    readonly source: ErrorSource;
+    readonly retryable?: boolean;
+    readonly details?: unknown;
+    readonly hint?: string;
+    constructor(options: {
+        message: string;
+        type: ErrorType;
+        exitCode: number;
+        severity?: ErrorSeverity;
+        source?: ErrorSource;
+        retryable?: boolean;
+        details?: unknown;
+        hint?: string;
+    });
 }
 export declare class UserInputError extends MediaProcError {
-    constructor(message: string, details?: any);
+    constructor(message: string, details?: unknown, hint?: string);
+}
+export declare class ValidationError extends MediaProcError {
+    constructor(message: string, details?: unknown, hint?: string);
+}
+export declare class ConfigError extends MediaProcError {
+    constructor(message: string, details?: unknown, hint?: string);
+}
+export declare class UnsupportedError extends MediaProcError {
+    constructor(message: string, details?: unknown, hint?: string);
+}
+export declare class NotImplementedError extends MediaProcError {
+    constructor(message?: string, details?: unknown);
 }
 export declare class FileSystemError extends MediaProcError {
-    constructor(message: string, details?: any);
+    constructor(message: string, details?: unknown, retryable?: boolean);
 }
 export declare class ToolError extends MediaProcError {
-    constructor(message: string, details?: any);
+    constructor(message: string, details?: unknown, retryable?: boolean);
 }
-export declare class UnsupportedError extends MediaProcError {
-    constructor(message: string, details?: any);
+export declare class DependencyError extends MediaProcError {
+    constructor(message: string, details?: unknown, hint?: string);
 }
 export declare class PluginError extends MediaProcError {
-    constructor(message: string, details?: any);
+    constructor(message: string, details?: unknown);
+}
+export declare class PluginNotFoundError extends MediaProcError {
+    constructor(message: string, details?: unknown);
+}
+export declare class CancelledError extends MediaProcError {
+    constructor(message?: string);
 }
 export declare class InternalError extends MediaProcError {
-    constructor(message: string, details?: any);
+    constructor(message: string, details?: unknown);
 }
+export declare function isMediaProcError(err: unknown): err is MediaProcError;
 //# sourceMappingURL=errorTypes.d.ts.map

package/dist/errors/errorTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorTypes.d.ts","sourceRoot":"","sources":["../../src/errors/errorTypes.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,WAAW,gBAAgB;IAC3B,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB;AAED,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAQ9E;AAED,qBAAa,cAAe,SAAQ,cAAc;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,eAAgB,SAAQ,cAAc;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,SAAU,SAAQ,cAAc;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,gBAAiB,SAAQ,cAAc;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,WAAY,SAAQ,cAAc;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C;AAED,qBAAa,aAAc,SAAQ,cAAc;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAI3C"}
+{"version":3,"file":"errorTypes.d.ts","sourceRoot":"","sources":["../../src/errors/errorTypes.ts"],"names":[],"mappings":"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"}

package/dist/errors/errorTypes.js

@@ -1,59 +1,232 @@
+/* ============================================================
+ * MediaProc Error System (v1.0-ready)
+ * ============================================================
+ */
+import { EXIT_CODES } from "./exitCodes.js";
+/* -------------------- Error Type -------------------- */
 export var ErrorType;
 (function (ErrorType) {
     ErrorType["UserInput"] = "UserInput";
+    ErrorType["Validation"] = "Validation";
+    ErrorType["Config"] = "Config";
+    ErrorType["Unsupported"] = "Unsupported";
+    ErrorType["NotImplemented"] = "NotImplemented";
     ErrorType["FileSystem"] = "FileSystem";
     ErrorType["Tool"] = "Tool";
-    ErrorType["Unsupported"] = "Unsupported";
+    ErrorType["Dependency"] = "Dependency";
     ErrorType["Plugin"] = "Plugin";
     ErrorType["Internal"] = "Internal";
+    ErrorType["Cancelled"] = "Cancelled";
 })(ErrorType || (ErrorType = {}));
+/* -------------------- Error Severity -------------------- */
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["Info"] = "Info";
+    ErrorSeverity["Warning"] = "Warning";
+    ErrorSeverity["Error"] = "Error";
+    ErrorSeverity["Fatal"] = "Fatal";
+})(ErrorSeverity || (ErrorSeverity = {}));
+/* -------------------- Error Source -------------------- */
+export var ErrorSource;
+(function (ErrorSource) {
+    ErrorSource["User"] = "User";
+    ErrorSource["MediaProc"] = "MediaProc";
+    ErrorSource["Plugin"] = "Plugin";
+    ErrorSource["ExternalTool"] = "ExternalTool";
+    ErrorSource["System"] = "System";
+})(ErrorSource || (ErrorSource = {}));
+/* -------------------- Base Error -------------------- */
 export class MediaProcError extends Error {
     type;
     exitCode;
+    severity;
+    source;
+    retryable;
     details;
-    constructor(message, type, exitCode, details) {
-        super(message);
+    hint;
+    constructor(options) {
+        super(options.message);
         this.name = 'MediaProcError';
-        this.type = type;
-        this.exitCode = exitCode;
-        this.details = details;
+        this.type = options.type;
+        this.exitCode = options.exitCode;
+        this.severity = options.severity ?? ErrorSeverity.Error;
+        this.source = options.source ?? ErrorSource.MediaProc;
+        this.retryable = options.retryable;
+        this.details = options.details;
+        this.hint = options.hint;
         Error.captureStackTrace?.(this, MediaProcError);
     }
 }
+/* -------------------- User / Validation -------------------- */
 export class UserInputError extends MediaProcError {
-    constructor(message, details) {
-        super(message, ErrorType.UserInput, 1, details);
+    constructor(message, details, hint) {
+        super({
+            message,
+            type: ErrorType.UserInput,
+            exitCode: EXIT_CODES.USER_INPUT,
+            severity: ErrorSeverity.Warning,
+            source: ErrorSource.User,
+            details,
+            hint,
+        });
         this.name = 'UserInputError';
     }
 }
+export class ValidationError extends MediaProcError {
+    constructor(message, details, hint) {
+        super({
+            message,
+            type: ErrorType.Validation,
+            exitCode: EXIT_CODES.VALIDATION,
+            severity: ErrorSeverity.Warning,
+            source: ErrorSource.User,
+            details,
+            hint,
+        });
+        this.name = 'ValidationError';
+    }
+}
+export class ConfigError extends MediaProcError {
+    constructor(message, details, hint) {
+        super({
+            message,
+            type: ErrorType.Config,
+            exitCode: EXIT_CODES.CONFIG,
+            severity: ErrorSeverity.Error,
+            source: ErrorSource.User,
+            details,
+            hint,
+        });
+        this.name = 'ConfigError';
+    }
+}
+export class UnsupportedError extends MediaProcError {
+    constructor(message, details, hint) {
+        super({
+            message,
+            type: ErrorType.Unsupported,
+            exitCode: EXIT_CODES.UNSUPPORTED,
+            severity: ErrorSeverity.Error,
+            source: ErrorSource.User,
+            details,
+            hint,
+        });
+        this.name = 'UnsupportedError';
+    }
+}
+export class NotImplementedError extends MediaProcError {
+    constructor(message = 'This feature is not implemented yet', details) {
+        super({
+            message,
+            type: ErrorType.NotImplemented,
+            exitCode: EXIT_CODES.NOT_IMPLEMENTED,
+            severity: ErrorSeverity.Info,
+            source: ErrorSource.MediaProc,
+            details,
+        });
+        this.name = 'NotImplementedError';
+    }
+}
+/* -------------------- File System -------------------- */
 export class FileSystemError extends MediaProcError {
-    constructor(message, details) {
-        super(message, ErrorType.FileSystem, 2, details);
+    constructor(message, details, retryable = false) {
+        super({
+            message,
+            type: ErrorType.FileSystem,
+            exitCode: EXIT_CODES.FS_ERROR,
+            severity: ErrorSeverity.Error,
+            source: ErrorSource.System,
+            retryable,
+            details,
+        });
         this.name = 'FileSystemError';
     }
 }
+/* -------------------- External Tools -------------------- */
 export class ToolError extends MediaProcError {
-    constructor(message, details) {
-        super(message, ErrorType.Tool, 3, details);
+    constructor(message, details, retryable = false) {
+        super({
+            message,
+            type: ErrorType.Tool,
+            exitCode: EXIT_CODES.TOOL_ERROR,
+            severity: ErrorSeverity.Fatal,
+            source: ErrorSource.ExternalTool,
+            retryable,
+            details,
+        });
         this.name = 'ToolError';
     }
 }
-export class UnsupportedError extends MediaProcError {
-    constructor(message, details) {
-        super(message, ErrorType.Unsupported, 4, details);
-        this.name = 'UnsupportedError';
+export class DependencyError extends MediaProcError {
+    constructor(message, details, hint) {
+        super({
+            message,
+            type: ErrorType.Dependency,
+            exitCode: EXIT_CODES.DEPENDENCY_MISSING,
+            severity: ErrorSeverity.Fatal,
+            source: ErrorSource.ExternalTool,
+            details,
+            hint,
+        });
+        this.name = 'DependencyError';
     }
 }
+/* -------------------- Plugin -------------------- */
 export class PluginError extends MediaProcError {
     constructor(message, details) {
-        super(message, ErrorType.Plugin, 5, details);
+        super({
+            message,
+            type: ErrorType.Plugin,
+            exitCode: EXIT_CODES.PLUGIN_ERROR,
+            severity: ErrorSeverity.Error,
+            source: ErrorSource.Plugin,
+            details,
+        });
         this.name = 'PluginError';
     }
 }
+export class PluginNotFoundError extends MediaProcError {
+    constructor(message, details) {
+        super({
+            message,
+            type: ErrorType.Plugin,
+            exitCode: EXIT_CODES.PLUGIN_NOT_FOUND,
+            severity: ErrorSeverity.Fatal,
+            source: ErrorSource.Plugin,
+            details,
+        });
+        this.name = 'PluginNotFoundError';
+    }
+}
+/* -------------------- Cancelled -------------------- */
+export class CancelledError extends MediaProcError {
+    constructor(message = 'Operation cancelled by user') {
+        super({
+            message,
+            type: ErrorType.Cancelled,
+            exitCode: EXIT_CODES.INTERRUPTED,
+            severity: ErrorSeverity.Info,
+            source: ErrorSource.User,
+        });
+        this.name = 'CancelledError';
+    }
+}
+/* -------------------- Internal -------------------- */
 export class InternalError extends MediaProcError {
     constructor(message, details) {
-        super(message, ErrorType.Internal, 6, details);
+        super({
+            message,
+            type: ErrorType.Internal,
+            exitCode: EXIT_CODES.INTERNAL,
+            severity: ErrorSeverity.Fatal,
+            source: ErrorSource.MediaProc,
+            details,
+        });
         this.name = 'InternalError';
     }
 }
+/* -------------------- Type Guard -------------------- */
+export function isMediaProcError(err) {
+    return err instanceof MediaProcError;
+}
 //# sourceMappingURL=errorTypes.js.map

package/dist/errors/errorTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorTypes.js","sourceRoot":"","sources":["../../src/errors/errorTypes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,sCAAyB,CAAA;IACzB,0BAAa,CAAA;IACb,wCAA2B,CAAA;IAC3B,8BAAiB,CAAA;IACjB,kCAAqB,CAAA;AACvB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,IAAI,CAAY;IAChB,QAAQ,CAAS;IACjB,OAAO,CAAO;IAEd,YAAY,OAAe,EAAE,IAAe,EAAE,QAAgB,EAAE,OAAa;QAC3E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,cAAc;IAC3C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,cAAc;IAC7C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"errorTypes.js","sourceRoot":"","sources":["../../src/errors/errorTypes.ts"],"names":[],"mappings":"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"}

package/dist/errors/exitCodes.d.ts

@@ -1,10 +1,26 @@
+/**
+ * Exit code ranges (documented contract):
+ * * 0       → success
+ * * 1–9     → user input / config / validation
+ * * 10–19   → filesystem
+ * * 20–29   → external tools (ffmpeg, sharp, etc.)
+ * * 30–39   → plugin system
+ * * 40–49   → internal errors
+ * * 130     → user interruption (SIGINT)
+ */
 export declare const EXIT_CODES: {
-    SUCCESS: number;
-    USER_INPUT: number;
-    FS_ERROR: number;
-    TOOL_ERROR: number;
-    UNSUPPORTED: number;
-    PLUGIN_ERROR: number;
-    INTERNAL: number;
+    readonly SUCCESS: 0;
+    readonly USER_INPUT: 1;
+    readonly VALIDATION: 2;
+    readonly CONFIG: 3;
+    readonly UNSUPPORTED: 4;
+    readonly NOT_IMPLEMENTED: 5;
+    readonly FS_ERROR: 10;
+    readonly TOOL_ERROR: 20;
+    readonly DEPENDENCY_MISSING: 21;
+    readonly PLUGIN_ERROR: 30;
+    readonly PLUGIN_NOT_FOUND: 31;
+    readonly INTERNAL: 40;
+    readonly INTERRUPTED: 130;
 };
 //# sourceMappingURL=exitCodes.d.ts.map

package/dist/errors/exitCodes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../src/errors/exitCodes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAA"}
+{"version":3,"file":"exitCodes.d.ts","sourceRoot":"","sources":["../../src/errors/exitCodes.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;CAoBb,CAAC"}

package/dist/errors/exitCodes.js

@@ -1,10 +1,27 @@
+/* -------------------- Exit Codes -------------------- */
+/**
+ * Exit code ranges (documented contract):
+ * * 0       → success
+ * * 1–9     → user input / config / validation
+ * * 10–19   → filesystem
+ * * 20–29   → external tools (ffmpeg, sharp, etc.)
+ * * 30–39   → plugin system
+ * * 40–49   → internal errors
+ * * 130     → user interruption (SIGINT)
+ */
 export const EXIT_CODES = {
-    SUCCESS: 0, // Meaning: Success
-    USER_INPUT: 1, // Meaning: Invalid user input (flags, args, paths)
-    FS_ERROR: 2, // Meaning: File system error (missing file, permission denied)
-    TOOL_ERROR: 3, // Meaning: External tool error (e.g., ffmpeg failure), Backend/tool error (ffmpeg, sharp, etc.)
-    UNSUPPORTED: 4, // Meaning: Unsupported operation or format
-    PLUGIN_ERROR: 5, // Meaning: Plugin-related error, Plugin not found or plugin load failure
-    INTERNAL: 6 // Meaning: Internal application error, Internal MediaProc error
+    SUCCESS: 0,
+    USER_INPUT: 1,
+    VALIDATION: 2,
+    CONFIG: 3,
+    UNSUPPORTED: 4,
+    NOT_IMPLEMENTED: 5,
+    FS_ERROR: 10,
+    TOOL_ERROR: 20,
+    DEPENDENCY_MISSING: 21,
+    PLUGIN_ERROR: 30,
+    PLUGIN_NOT_FOUND: 31,
+    INTERNAL: 40,
+    INTERRUPTED: 130,
 };
 //# sourceMappingURL=exitCodes.js.map

package/dist/errors/exitCodes.js.map

@@ -1 +1 @@
-{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/errors/exitCodes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,OAAO,EAAE,CAAC,EAAE,mBAAmB;IAC/B,UAAU,EAAE,CAAC,EAAE,mDAAmD;IAClE,QAAQ,EAAE,CAAC,EAAE,+DAA+D;IAC5E,UAAU,EAAE,CAAC,EAAE,gGAAgG;IAC/G,WAAW,EAAE,CAAC,EAAE,2CAA2C;IAC3D,YAAY,EAAE,CAAC,EAAE,yEAAyE;IAC1F,QAAQ,EAAE,CAAC,CAAC,gEAAgE;CAC/E,CAAA"}
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../src/errors/exitCodes.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IAEV,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAElB,QAAQ,EAAE,EAAE;IAEZ,UAAU,EAAE,EAAE;IACd,kBAAkB,EAAE,EAAE;IAEtB,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,EAAE;IAEpB,QAAQ,EAAE,EAAE;IAEZ,WAAW,EAAE,GAAG;CACR,CAAC"}

package/dist/explain/explainFlag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../../src/explain/explainFlag.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,IAAwB,GACzB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,QAgKA"}
+{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../../src/explain/explainFlag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,IAAwB,GACzB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,QAoOA"}