@asciiz/atoolkit 0.1.0

package/dist/acircuit/composite.d.ts

@@ -0,0 +1,32 @@
+import { Chip } from "./chip.js";
+import type { Circuit } from "./circuit.js";
+import type { ProcessCtx } from "./types.js";
+export interface InputSocketMapping {
+    outerSocket: string;
+    innerChipId: string;
+    innerSocket: string;
+}
+export interface OutputSocketMapping {
+    outerSocket: string;
+    innerChipId: string;
+    innerSocket: string;
+}
+/**
+ * Composite chip encapsulating an inner Circuit graph.
+ */
+export declare class Subcircuit extends Chip {
+    readonly innerCircuit: Circuit;
+    readonly inputMappings: Map<string, InputSocketMapping>;
+    readonly outputMappings: Map<string, OutputSocketMapping>;
+    constructor(id: string, name: string, innerCircuit: Circuit);
+    /**
+     * Maps an external input socket to an internal chip's input socket.
+     */
+    mapInput(outerSocketName: string, innerChipId: string, innerSocketName: string, dataType?: string): this;
+    /**
+     * Maps an internal chip's output socket to an external output socket.
+     */
+    mapOutput(outerSocketName: string, innerChipId: string, innerSocketName: string, dataType?: string): this;
+    process(inputs: Record<string, any>, ctx?: ProcessCtx<any>): Record<string, any>;
+}
+//# sourceMappingURL=composite.d.ts.map

package/dist/acircuit/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../../acircuit/composite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,IAAI;IAChC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,kCAAyC;IAC/D,QAAQ,CAAC,cAAc,mCAA0C;gBAErD,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO;IAK3D;;OAEG;IACH,QAAQ,CACJ,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,GAClB,IAAI;IAmBP;;OAEG;IACH,SAAS,CACL,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,GAClB,IAAI;IAmBE,OAAO,CACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,GACtB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAqCzB"}

package/dist/acircuit/composite.js

@@ -0,0 +1,88 @@
+import { Chip } from "./chip.js";
+/**
+ * Composite chip encapsulating an inner Circuit graph.
+ */
+export class Subcircuit extends Chip {
+    innerCircuit;
+    inputMappings = new Map();
+    outputMappings = new Map();
+    constructor(id, name, innerCircuit) {
+        super(id, name);
+        this.innerCircuit = innerCircuit;
+    }
+    /**
+     * Maps an external input socket to an internal chip's input socket.
+     */
+    mapInput(outerSocketName, innerChipId, innerSocketName, dataType) {
+        const innerChip = this.innerCircuit.getChip(innerChipId);
+        if (!innerChip) {
+            throw new Error(`[Subcircuit] Inner chip "${innerChipId}" not found in subcircuit.`);
+        }
+        const innerSocket = innerChip.getInput(innerSocketName);
+        if (!innerSocket) {
+            throw new Error(`[Subcircuit] Inner input socket "${innerChipId}:${innerSocketName}" not found.`);
+        }
+        const effectiveType = dataType ?? innerSocket.dataType;
+        this.addInput(outerSocketName, effectiveType);
+        this.inputMappings.set(outerSocketName, {
+            outerSocket: outerSocketName,
+            innerChipId,
+            innerSocket: innerSocketName,
+        });
+        return this;
+    }
+    /**
+     * Maps an internal chip's output socket to an external output socket.
+     */
+    mapOutput(outerSocketName, innerChipId, innerSocketName, dataType) {
+        const innerChip = this.innerCircuit.getChip(innerChipId);
+        if (!innerChip) {
+            throw new Error(`[Subcircuit] Inner chip "${innerChipId}" not found in subcircuit.`);
+        }
+        const innerSocket = innerChip.getOutput(innerSocketName);
+        if (!innerSocket) {
+            throw new Error(`[Subcircuit] Inner output socket "${innerChipId}:${innerSocketName}" not found.`);
+        }
+        const effectiveType = dataType ?? innerSocket.dataType;
+        this.addOutput(outerSocketName, effectiveType);
+        this.outputMappings.set(outerSocketName, {
+            outerSocket: outerSocketName,
+            innerChipId,
+            innerSocket: innerSocketName,
+        });
+        return this;
+    }
+    process(inputs, ctx) {
+        const overrides = {};
+        for (const [outerName, mapping] of this.inputMappings) {
+            const val = inputs[outerName];
+            if (val !== undefined) {
+                let chipOverrides = overrides[mapping.innerChipId];
+                if (!chipOverrides) {
+                    chipOverrides = {};
+                    overrides[mapping.innerChipId] = chipOverrides;
+                }
+                chipOverrides[mapping.innerSocket] = val;
+            }
+        }
+        const runResult = this.innerCircuit.run({
+            overrides,
+            ctx: ctx?.ctx,
+        });
+        if (runResult.errors.length > 0) {
+            const first = runResult.errors[0];
+            throw first.error instanceof Error
+                ? first.error
+                : new Error(`[Subcircuit] Inner execution failed on chip "${first.chipId}": ${String(first.error)}`);
+        }
+        const outputs = {};
+        for (const [outerName, mapping] of this.outputMappings) {
+            const chipOuts = runResult.outputs.get(mapping.innerChipId);
+            if (chipOuts && chipOuts[mapping.innerSocket] !== undefined) {
+                outputs[outerName] = chipOuts[mapping.innerSocket];
+            }
+        }
+        return outputs;
+    }
+}
+//# sourceMappingURL=composite.js.map

package/dist/acircuit/composite.js.map

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

package/dist/acircuit/index.d.ts

@@ -0,0 +1,7 @@
+export { Socket, type SocketDirection, type SocketOptions, } from "./socket.js";
+export { Chip, ChipProxy, } from "./chip.js";
+export { Circuit, type CircuitOptions, } from "./circuit.js";
+export { Subcircuit, type InputSocketMapping, type OutputSocketMapping, } from "./composite.js";
+export { type Wire, inSocketKey, outSocketKey, wireEquals, formatWire, } from "./wire.js";
+export type { ProcessCtx, RunOptions, RunResult, CircuitIssueType, CircuitIssue, CircuitValidationResult, SerializedSocket, SerializedChip, SerializedCircuit, ChipFactory, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/acircuit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../acircuit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EACN,KAAK,eAAe,EACpB,KAAK,aAAa,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,IAAI,EACJ,SAAS,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,OAAO,EACP,KAAK,cAAc,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACH,KAAK,IAAI,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,WAAW,GACd,MAAM,YAAY,CAAC"}

package/dist/acircuit/index.js

@@ -0,0 +1,6 @@
+export { Socket, } from "./socket.js";
+export { Chip, ChipProxy, } from "./chip.js";
+export { Circuit, } from "./circuit.js";
+export { Subcircuit, } from "./composite.js";
+export { inSocketKey, outSocketKey, wireEquals, formatWire, } from "./wire.js";
+//# sourceMappingURL=index.js.map

package/dist/acircuit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../acircuit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,GAGT,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,IAAI,EACJ,SAAS,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EACH,OAAO,GAEV,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,UAAU,GAGb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEH,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,GACb,MAAM,WAAW,CAAC"}

package/dist/acircuit/socket.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Communication endpoint direction.
+ */
+export type SocketDirection = "input" | "output";
+export interface SocketOptions {
+    dataType?: string;
+    required?: boolean;
+}
+/**
+ * Communication endpoint on a Chip.
+ * Identifies an input or output endpoint on a chip with optional type and requirement tags.
+ */
+export declare class Socket {
+    readonly name: string;
+    readonly direction: SocketDirection;
+    readonly dataType?: string;
+    readonly required: boolean;
+    constructor(name: string, direction?: SocketDirection, options?: SocketOptions | string);
+}
+//# sourceMappingURL=socket.d.ts.map

package/dist/acircuit/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../acircuit/socket.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,MAAM;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAGvB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,eAAyB,EACpC,OAAO,GAAE,aAAa,GAAG,MAAW;CAY3C"}

package/dist/acircuit/socket.js

@@ -0,0 +1,23 @@
+/**
+ * Communication endpoint on a Chip.
+ * Identifies an input or output endpoint on a chip with optional type and requirement tags.
+ */
+export class Socket {
+    name;
+    direction;
+    dataType;
+    required;
+    constructor(name, direction = "input", options = {}) {
+        this.name = name;
+        this.direction = direction;
+        if (typeof options === "string") {
+            this.dataType = options;
+            this.required = true;
+        }
+        else {
+            this.dataType = options.dataType;
+            this.required = options.required ?? true;
+        }
+    }
+}
+//# sourceMappingURL=socket.js.map

package/dist/acircuit/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../acircuit/socket.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,MAAM;IACN,IAAI,CAAS;IACb,SAAS,CAAkB;IAC3B,QAAQ,CAAU;IAClB,QAAQ,CAAU;IAE3B,YACI,IAAY,EACZ,YAA6B,OAAO,EACpC,UAAkC,EAAE;QAEpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAC7C,CAAC;IACL,CAAC;CACJ"}

package/dist/acircuit/types.d.ts

@@ -0,0 +1,94 @@
+import type { Wire } from "./wire.js";
+import type { SocketDirection } from "./socket.js";
+import type { Chip } from "./chip.js";
+export type { Wire };
+/**
+ * Execution context passed to chip.process(inputs, ctx).
+ */
+export interface ProcessCtx<TCtx = unknown> {
+    /** User context forwarded through execution */
+    ctx?: TCtx;
+}
+/**
+ * Configuration for topological runs.
+ */
+export interface RunOptions<TCtx = unknown, TChip = unknown> {
+    /** User context forwarded to chip.process(inputs, ctx) */
+    ctx?: TCtx;
+    /** Initial input socket values: { [chipId]: { [socketName]: value } } */
+    overrides?: Record<string, Record<string, any>>;
+    /** Callback invoked before chip execution */
+    onChipEnter?: (chip: TChip, inputs: Record<string, any>) => void;
+    /** Callback invoked after chip execution */
+    onChipLeave?: (chip: TChip, outputs: Record<string, any>) => void;
+    /** Callback invoked on wire value resolution */
+    onWireTransmit?: (wire: Wire, value: any) => void;
+}
+/**
+ * Result of a circuit execution run.
+ */
+export interface RunResult<TChip = unknown> {
+    /** Mapping of chip ID to computed output socket records */
+    outputs: Map<string, Record<string, any>>;
+    /** Chips executed in topological order */
+    executedChips: TChip[];
+    /** Caught execution errors */
+    errors: Array<{
+        chipId: string;
+        error: unknown;
+    }>;
+}
+/**
+ * Classification of structural graph validation issue.
+ */
+export type CircuitIssueType = "cycle" | "missing_input" | "type_mismatch" | "isolated_chip";
+/**
+ * Diagnostic descriptor representing a validation defect.
+ */
+export interface CircuitIssue {
+    type: CircuitIssueType;
+    message: string;
+    chipId?: string;
+    socketName?: string;
+    wire?: Wire;
+}
+/**
+ * Result of static circuit validation pass.
+ */
+export interface CircuitValidationResult {
+    valid: boolean;
+    issues: CircuitIssue[];
+}
+/**
+ * Serialized representation of a socket endpoint.
+ */
+export interface SerializedSocket {
+    name: string;
+    direction: SocketDirection;
+    dataType?: string;
+    required?: boolean;
+}
+/**
+ * Serialized representation of a circuit chip.
+ */
+export interface SerializedChip {
+    id: string;
+    name: string;
+    type?: string;
+    inputs: SerializedSocket[];
+    outputs: SerializedSocket[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Serialized representation of an entire circuit topology.
+ */
+export interface SerializedCircuit {
+    label: string;
+    chips: SerializedChip[];
+    wires: Wire[];
+}
+/**
+ * Factory callback instantiating a Chip from serialized data.
+ */
+export type ChipFactory = (serialized: SerializedChip) => Chip;
+//# sourceMappingURL=types.d.ts.map

package/dist/acircuit/types.d.ts.map

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

package/dist/acircuit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/acircuit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../acircuit/types.ts"],"names":[],"mappings":""}

package/dist/acircuit/wire.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Directed connection between output socket and input socket in Circuit graph.
+ *
+ * - Output sockets support 1-to-N fan-out.
+ * - Input sockets enforce 1-to-1 connection.
+ */
+export interface Wire {
+    readonly outChipId: string;
+    readonly outSocket: string;
+    readonly inChipId: string;
+    readonly inSocket: string;
+}
+/**
+ * Returns the lookup key for a socket endpoint.
+ */
+export declare function inSocketKey(chipId: string, socketName: string): string;
+export declare const outSocketKey: typeof inSocketKey;
+/**
+ * Compares two Wire instances for matching endpoints.
+ */
+export declare function wireEquals(a: Wire, b: Wire): boolean;
+/**
+ * Formats a Wire as (outChip:outSocket -> inChip:inSocket).
+ */
+export declare function formatWire(wire: Wire): string;
+//# sourceMappingURL=wire.d.ts.map

package/dist/acircuit/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../acircuit/wire.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,eAAO,MAAM,YAAY,oBAAc,CAAC;AAExC;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAOpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C"}

package/dist/acircuit/wire.js

@@ -0,0 +1,23 @@
+/**
+ * Returns the lookup key for a socket endpoint.
+ */
+export function inSocketKey(chipId, socketName) {
+    return `${chipId}:${socketName}`;
+}
+export const outSocketKey = inSocketKey;
+/**
+ * Compares two Wire instances for matching endpoints.
+ */
+export function wireEquals(a, b) {
+    return (a.outChipId === b.outChipId &&
+        a.outSocket === b.outSocket &&
+        a.inChipId === b.inChipId &&
+        a.inSocket === b.inSocket);
+}
+/**
+ * Formats a Wire as (outChip:outSocket -> inChip:inSocket).
+ */
+export function formatWire(wire) {
+    return `(${wire.outChipId}:${wire.outSocket} -> ${wire.inChipId}:${wire.inSocket})`;
+}
+//# sourceMappingURL=wire.js.map

package/dist/acircuit/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../acircuit/wire.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAAkB;IAC1D,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAO,EAAE,CAAO;IACvC,OAAO,CACH,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;QAC3B,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;QAC3B,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QACzB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAC5B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACjC,OAAO,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC;AACxF,CAAC"}

package/dist/adiag/bus.d.ts

@@ -0,0 +1,65 @@
+export type Type = "ok" | "err" | "warn" | "info" | string;
+export interface Result {
+    type: Type;
+    code: string;
+    raw: string;
+    data: unknown;
+    ref?: Result | null;
+}
+export interface AddArgs {
+    code?: string;
+    raw?: string;
+    data?: unknown;
+    ref?: Result | null;
+}
+export declare class Bus {
+    #private;
+    state: Record<string, unknown>;
+    readonly maxHistory: number;
+    private readonly _listeners;
+    static readonly TYPE_OK = "ok";
+    static readonly TYPE_ERR = "err";
+    static readonly TYPE_WARN = "warn";
+    static readonly TYPE_INFO = "info";
+    constructor(maxHistory?: number);
+    get results(): Result[];
+    set results(items: Result[]);
+    ok(args?: AddArgs): Result;
+    err(args?: AddArgs): Result;
+    warn(args?: AddArgs): Result;
+    info(args?: AddArgs): Result;
+    /**
+     * Subscribes to diagnostic records of specified category type, or '*' for all records.
+     * Returns an unsubscribe function.
+     */
+    on(type: Type | "*", listener: (result: Result) => void): () => void;
+    onError(listener: (result: Result) => void): () => void;
+    onWarn(listener: (result: Result) => void): () => void;
+    clear(): void;
+    last(): Result | null;
+    lastErr(): Result | null;
+    allOk(): boolean;
+    private _findType;
+    findOk(): Result[];
+    hasErrs(): boolean;
+    findErrs(): Result[];
+    hasWarns(): boolean;
+    findWarns(): Result[];
+    hasInfos(): boolean;
+    findInfos(): Result[];
+    /**
+     * Extracts the causal reference chain starting from `result` in order of causality.
+     */
+    static getCauseChain(result: Result | null | undefined): Result[];
+    static compileMsg(raw?: string, data?: Record<string, unknown>): string;
+    /**
+     * Formats diagnostic result into human-readable string with causal chain details.
+     */
+    static formatResult(result: Result): string;
+    static resultToMsg(result: Result): string;
+    /**
+     * Compiles full message including causal chain explanations
+     */
+    static resultToChainMsg(result: Result): string;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/adiag/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../adiag/bus.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID,qBAAa,GAAG;;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAK5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoD;IAE/E,MAAM,CAAC,QAAQ,CAAC,OAAO,QAAU;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAU;IAClC,MAAM,CAAC,QAAQ,CAAC,SAAS,UAAU;IACnC,MAAM,CAAC,QAAQ,CAAC,SAAS,UAAU;gBAEvB,UAAU,SAAO;IAK7B,IAAI,OAAO,IAAI,MAAM,EAAE,CAQtB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAM1B;IAED,EAAE,CAAC,IAAI,GAAE,OAAY,GAAK,MAAM;IAChC,GAAG,CAAC,IAAI,GAAE,OAAY,GAAI,MAAM;IAChC,IAAI,CAAC,IAAI,GAAE,OAAY,GAAG,MAAM;IAChC,IAAI,CAAC,IAAI,GAAE,OAAY,GAAG,MAAM;IAEhC;;;OAGG;IACH,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAapE,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAIvD,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAwBtD,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,MAAM,GAAG,IAAI;IAMrB,OAAO,IAAI,MAAM,GAAG,IAAI;IAWxB,KAAK,IAAI,OAAO;IAShB,OAAO,CAAC,SAAS;IAajB,MAAM,IAAI,MAAM,EAAE;IAIlB,OAAO,IAAI,OAAO;IAIlB,QAAQ,IAAI,MAAM,EAAE;IAIpB,QAAQ,IAAI,OAAO;IASnB,SAAS,IAAI,MAAM,EAAE;IAIrB,QAAQ,IAAI,OAAO;IASnB,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE;IAkBjE,MAAM,CAAC,UAAU,CAAC,GAAG,SAAK,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM;IA2BvE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAM3C,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAIlD"}