incanto 0.1.0

package/dist/errors-BMFaY68Q.d.ts

@@ -0,0 +1,33 @@
+//#region src/core/errors.d.ts
+/**
+* Stable error codes for every hard failure in the engine.
+*
+* Incanto fails loudly with machine-readable codes and messages that list valid
+* alternatives — AI agents self-correct on hard failures, not warnings.
+*/
+type IncantoErrorCode = "BAD_FORMAT" | "BAD_NODE_PATH" | "DANGLING_CONNECTION" | "DUPLICATE_BEHAVIOR" | "DUPLICATE_NODE_TYPE" | "DUPLICATE_UNIQUE_NAME" | "DUPLICATE_UID" | "NODE_NOT_FOUND" | "PROP_TYPE_MISMATCH" | "TREE_VIOLATION" | "UNKNOWN_ANIMATION" | "UNKNOWN_ASSET" | "UNKNOWN_CONSTANT" | "UNKNOWN_BEHAVIOR" | "UNKNOWN_HANDLER" | "UNKNOWN_NODE_TYPE" | "UNKNOWN_PROP" | "UNKNOWN_SIGNAL" | "UNRESOLVED_INSTANCE";
+/**
+* Structured context mirrored from the prose message — tools and agents parse
+* THESE instead of regexing the message (which is for humans and may reword).
+*/
+interface IncantoErrorDetails {
+  /** Absolute path of the offending node in the scene being loaded ('/Root/Child'). */
+  readonly path?: string;
+  /** The offending node's uid, when the scene JSON declared one. */
+  readonly uid?: string;
+  /** The offending node's type name. */
+  readonly nodeType?: string;
+  /** The offending prop key. */
+  readonly prop?: string;
+  /** The offending signal name. */
+  readonly signal?: string;
+  /** The valid alternatives the message also lists — for programmatic self-correction. */
+  readonly validOptions?: readonly string[];
+}
+declare class IncantoError extends Error {
+  readonly code: IncantoErrorCode;
+  readonly details: IncantoErrorDetails;
+  constructor(code: IncantoErrorCode, message: string, details?: IncantoErrorDetails);
+}
+//#endregion
+export { IncantoErrorCode as n, IncantoErrorDetails as r, IncantoError as t };

package/dist/errors-BpWbnbb_.js

@@ -0,0 +1,13 @@
+//#region src/core/errors.ts
+var IncantoError = class extends Error {
+	code;
+	details;
+	constructor(code, message, details = {}) {
+		super(message);
+		this.name = "IncantoError";
+		this.code = code;
+		this.details = details;
+	}
+};
+//#endregion
+export { IncantoError as t };