juxscript 1.0.87 → 1.0.89

package/lib/componentsv2/base/BaseEngine.d.ts

@@ -1,3 +1,4 @@
+import { OptionsContractSchema, ValidationResult } from './OptionsContract.js';
 export interface JuxServiceContract<TEngine = any> {
     name: string;
     version?: string;
@@ -24,6 +25,15 @@ type EventListener<T = any> = (data: T) => void;
 export declare abstract class BaseEngine<TState extends BaseState, TOptions = any> {
     #private;
     constructor(id: string, options: TOptions);
+    /**
+     * CONTRACT: Override to define the valid options schema for this engine.
+     * Enables option validation with helpful error messages.
+     */
+    protected get optionsSchema(): OptionsContractSchema | null;
+    /**
+     * Access validation results (warnings, errors, normalized options)
+     */
+    get validation(): ValidationResult | null;
     /**
      * CONTRACT: Must transform input options into the initial State.
      * This separates "mapping logic" from "construction/startup logic".

package/lib/componentsv2/base/BaseEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseEngine.d.ts","sourceRoot":"","sources":["BaseEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BaseEngine.d.ts","sourceRoot":"","sources":["BaseEngine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGhG,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC9C,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,KAAK,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,8BAAsB,UAAU,CAAC,MAAM,SAAS,SAAS,EAAE,QAAQ,GAAG,GAAG;;gBASzD,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;IAkBzC;;;OAGG;IACH,SAAS,KAAK,aAAa,IAAI,qBAAqB,GAAG,IAAI,CAE1D;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,gBAAgB,GAAG,IAAI,CAExC;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,MAAM;IAEtE,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAI3C;;OAEG;IACH,KAAK,CAAC,OAAO,GAAE,OAAc,GAAG,IAAI;IAQpC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAUnD;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAQ5D;;OAEG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAK7D;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;IAOpE;;OAEG;IACH,OAAO,IAAI,IAAI;IAkBf;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAwB9C;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAE5C;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,EAAE,CAE1B;IAMD;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBjD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoBhC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASjC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASpC,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAMjC,OAAO,CAAC,UAAU,GAAE,OAAc,GAAG,IAAI;IAMzC,OAAO,CAAC,SAAS,GAAE,OAAc,GAAG,IAAI;IAMxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAQzC"}

package/lib/componentsv2/base/BaseEngine.js

@@ -1,17 +1,18 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _BaseEngine_state, _BaseEngine_listeners, _BaseEngine_cleanupListeners, _BaseEngine_plugins, _BaseEngine_emitHistory, _BaseEngine_debugMode;
+var _BaseEngine_state, _BaseEngine_listeners, _BaseEngine_cleanupListeners, _BaseEngine_plugins, _BaseEngine_emitHistory, _BaseEngine_debugMode, _BaseEngine_validationResult;
 import { State } from './State.js';
 import { GlobalBus } from './GlobalBus.js';
+import { validateOptions } from './OptionsContract.js';
 /**
  * THE ENGINE AGREEMENT
  *
@@ -27,10 +28,30 @@ export class BaseEngine {
         _BaseEngine_plugins.set(this, new Map());
         _BaseEngine_emitHistory.set(this, []);
         _BaseEngine_debugMode.set(this, false);
+        _BaseEngine_validationResult.set(this, null);
+        // Validate options if schema is defined
+        const schema = this.optionsSchema;
+        if (schema) {
+            __classPrivateFieldSet(this, _BaseEngine_validationResult, validateOptions(this.constructor.name, options, schema, __classPrivateFieldGet(this, _BaseEngine_debugMode, "f")), "f");
+            options = __classPrivateFieldGet(this, _BaseEngine_validationResult, "f").normalized;
+        }
         // Enforce the Contract: Child must define how state is born from options
         const initialState = this.prepareState(id, options);
         __classPrivateFieldSet(this, _BaseEngine_state, new State(initialState), "f");
     }
+    /**
+     * CONTRACT: Override to define the valid options schema for this engine.
+     * Enables option validation with helpful error messages.
+     */
+    get optionsSchema() {
+        return null; // Override in child classes
+    }
+    /**
+     * Access validation results (warnings, errors, normalized options)
+     */
+    get validation() {
+        return __classPrivateFieldGet(this, _BaseEngine_validationResult, "f");
+    }
     get state() {
         return __classPrivateFieldGet(this, _BaseEngine_state, "f").value;
     }
@@ -254,5 +275,5 @@ export class BaseEngine {
         return this;
     }
 }
-_BaseEngine_state = new WeakMap(), _BaseEngine_listeners = new WeakMap(), _BaseEngine_cleanupListeners = new WeakMap(), _BaseEngine_plugins = new WeakMap(), _BaseEngine_emitHistory = new WeakMap(), _BaseEngine_debugMode = new WeakMap();
+_BaseEngine_state = new WeakMap(), _BaseEngine_listeners = new WeakMap(), _BaseEngine_cleanupListeners = new WeakMap(), _BaseEngine_plugins = new WeakMap(), _BaseEngine_emitHistory = new WeakMap(), _BaseEngine_debugMode = new WeakMap(), _BaseEngine_validationResult = new WeakMap();
 //# sourceMappingURL=BaseEngine.js.map

package/lib/componentsv2/base/BaseEngine.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseEngine.js","sourceRoot":"","sources":["BaseEngine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BaseEngine.js","sourceRoot":"","sources":["BaseEngine.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAA2C,MAAM,sBAAsB,CAAC;AAsBhG;;;;;;GAMG;AACH,MAAM,OAAgB,UAAU;IAS5B,YAAY,EAAU,EAAE,OAAiB;QARzC,oCAAsB;QACtB,gCAAa,IAAI,GAAG,EAA8B,EAAC;QACnD,uCAAuC,EAAE,EAAC;QAC1C,8BAAW,IAAI,GAAG,EAA8B,EAAC;QACjD,kCAAyB,EAAE,EAAC;QAC5B,gCAAa,KAAK,EAAC;QACnB,uCAA6C,IAAI,EAAC;QAG9C,wCAAwC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACT,uBAAA,IAAI,gCAAqB,eAAe,CACpC,IAAI,CAAC,WAAW,CAAC,IAAI,EACrB,OAA8B,EAC9B,MAAM,EACN,uBAAA,IAAI,6BAAW,CAClB,MAAA,CAAC;YACF,OAAO,GAAG,uBAAA,IAAI,oCAAkB,CAAC,UAAsB,CAAC;QAC5D,CAAC;QAED,yEAAyE;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,uBAAA,IAAI,qBAAU,IAAI,KAAK,CAAC,YAAY,CAAC,MAAA,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,IAAc,aAAa;QACvB,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,uBAAA,IAAI,oCAAkB,CAAC;IAClC,CAAC;IAQD,IAAI,KAAK;QACL,OAAO,uBAAA,IAAI,yBAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,QAAiC;QACvC,OAAO,uBAAA,IAAI,yBAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAmB,IAAI;QACzB,uBAAA,IAAI,yBAAc,OAAO,MAAA,CAAC;QAC1B,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,oCAAoC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,oCAAoC,EAAE,oBAAoB,CAAC,CAAC;QAClI,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAES,WAAW,CAAC,KAAsB;QACxC,IAAI,uBAAA,IAAI,6BAAW,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,oCAAoC,EAAE,aAAa,CAAC,CAAC;YAC/G,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,uBAAA,IAAI,yBAAO,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,CAAC;QACD,uBAAA,IAAI,yBAAO,CAAC,GAAG,CAAC,EAAE,GAAG,uBAAA,IAAI,yBAAO,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,uBAAA,IAAI,yBAAO,CAAC,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,uBAAA,IAAI,yBAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,mBAAmB;QACjF,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACnC,CAAC;IAED;;OAEG;IACH,WAAW;QACP,uBAAA,IAAI,yBAAO,CAAC,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,uBAAA,IAAI,yBAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,mBAAmB;QACpF,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACnC,CAAC;IAED,6BAA6B;IAE7B;;OAEG;IACH,EAAE,CAAU,KAAa,EAAE,QAA0B;QACjD,IAAI,CAAC,uBAAA,IAAI,6BAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,uBAAA,IAAI,6BAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,uBAAA,IAAI,6BAAW,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,GAAG,CAAU,KAAa,EAAE,QAA0B;QAClD,uBAAA,IAAI,6BAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAU,OAAe,EAAE,QAA0B;QACzD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChC,oBAAoB;QACpB,uBAAA,IAAI,oCAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,OAAO;QACH,uBAAuB;QACvB,uBAAA,IAAI,2BAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACtB,IAAI,CAAC;gBACD,IAAI,CAAC,CAAC,SAAS;oBAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;YACjE,CAAC;QACL,CAAC,CAAC,CAAC;QACH,uBAAA,IAAI,2BAAS,CAAC,KAAK,EAAE,CAAC;QAEtB,qBAAqB;QACrB,uBAAA,IAAI,oCAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,uBAAA,IAAI,gCAAqB,EAAE,MAAA,CAAC;QAE5B,IAAI,uBAAA,IAAI,6BAAW;YAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;IACzF,CAAC;IAED;;;OAGG;IACO,IAAI,CAAC,KAAa,EAAE,IAAS;QACnC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,oBAAoB;QACpB,uBAAA,IAAI,+BAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEnE,IAAI,uBAAA,IAAI,6BAAW,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,EAAE,EAAE,oCAAoC,EAAE,iCAAiC,EAAE,IAAI,CAAC,CAAC;QAC1I,CAAC;QAED,4BAA4B;QAC5B,uBAAA,IAAI,6BAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAEpD,0CAA0C;QAC1C,kCAAkC;QAClC,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;QAElD,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE;YAC1B,GAAG,IAAI;YACP,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;SACzB,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACb,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,YAAY;QACZ,OAAO,uBAAA,IAAI,yBAAO,CAAC,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACX,OAAO,CAAC,GAAG,uBAAA,IAAI,+BAAa,CAAC,CAAC;IAClC,CAAC;IAED;;2EAEuE;IAEvE;;;OAGG;IACH,SAAS,CAAC,MAAgC;QACtC,IAAI,uBAAA,IAAI,2BAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,IAAI,2BAA2B,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,uBAAA,IAAI,6BAAW,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,OAAO,IAAI,GAAG,GAAG,EAAE,oCAAoC,EAAE,aAAa,CAAC,CAAC;QAC9I,CAAC;QAED,uBAAA,IAAI,2BAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEvC,IAAI,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;YACrE,mCAAmC;YACnC,uBAAA,IAAI,2BAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY;QACrB,MAAM,MAAM,GAAG,uBAAA,IAAI,2BAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC;YACT,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,mCAAmC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;gBACnE,CAAC;YACL,CAAC;YACD,uBAAA,IAAI,2BAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;2EAEuE;IAEvE,QAAQ,CAAC,SAAiB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,EAAqB,CAAC,CAAC;YAC1E,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,WAAW,CAAC,SAAiB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC;YACb,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAC7B,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,SAAkB;QACtB,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,SAAS,EAAqB,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,aAAsB,IAAI;QAC9B,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAqB,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,YAAqB,IAAI;QAC7B,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,SAAS,EAAqB,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,KAAa;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QACtC,IAAI,CAAC,WAAW,CAAC;YACb,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;SACxB,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/lib/componentsv2/base/BaseEngine.ts

@@ -1,5 +1,6 @@
 import { State } from './State.js';
 import { GlobalBus } from './GlobalBus.js';
+import { validateOptions, OptionsContractSchema, ValidationResult } from './OptionsContract.js';
 
 
 export interface JuxServiceContract<TEngine = any> {
@@ -35,13 +36,41 @@ export abstract class BaseEngine<TState extends BaseState, TOptions = any> {
     #plugins = new Map<string, JuxServiceContract>();
     #emitHistory: string[] = [];
     #debugMode = false;
+    #validationResult: ValidationResult | null = null;
 
     constructor(id: string, options: TOptions) {
+        // Validate options if schema is defined
+        const schema = this.optionsSchema;
+        if (schema) {
+            this.#validationResult = validateOptions(
+                this.constructor.name,
+                options as Record<string, any>,
+                schema,
+                this.#debugMode
+            );
+            options = this.#validationResult.normalized as TOptions;
+        }
+
         // Enforce the Contract: Child must define how state is born from options
         const initialState = this.prepareState(id, options);
         this.#state = new State(initialState);
     }
 
+    /**
+     * CONTRACT: Override to define the valid options schema for this engine.
+     * Enables option validation with helpful error messages.
+     */
+    protected get optionsSchema(): OptionsContractSchema | null {
+        return null; // Override in child classes
+    }
+
+    /**
+     * Access validation results (warnings, errors, normalized options)
+     */
+    get validation(): ValidationResult | null {
+        return this.#validationResult;
+    }
+
     /**
      * CONTRACT: Must transform input options into the initial State.
      * This separates "mapping logic" from "construction/startup logic".

package/lib/componentsv2/base/OptionsContract.d.ts

@@ -0,0 +1,20 @@
+export interface OptionDefinition {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'function';
+    required?: boolean;
+    default?: any;
+    description?: string;
+    aliases?: string[];
+}
+export type OptionsContractSchema = Record<string, OptionDefinition>;
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+    normalized: Record<string, any>;
+}
+/**
+ * Validates user-provided options against a defined contract schema.
+ * Emits warnings for unknown/misnamed options and errors for type mismatches.
+ */
+export declare function validateOptions<T extends Record<string, any>>(componentName: string, userOptions: Record<string, any>, schema: OptionsContractSchema, debugMode?: boolean): ValidationResult;
+//# sourceMappingURL=OptionsContract.d.ts.map

package/lib/componentsv2/base/OptionsContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionsContract.d.ts","sourceRoot":"","sources":["OptionsContract.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzD,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChC,MAAM,EAAE,qBAAqB,EAC7B,SAAS,GAAE,OAAe,GAC3B,gBAAgB,CAqElB"}

package/lib/componentsv2/base/OptionsContract.js

@@ -0,0 +1,107 @@
+/**
+ * Validates user-provided options against a defined contract schema.
+ * Emits warnings for unknown/misnamed options and errors for type mismatches.
+ */
+export function validateOptions(componentName, userOptions, schema, debugMode = false) {
+    const result = {
+        valid: true,
+        warnings: [],
+        errors: [],
+        normalized: {}
+    };
+    const validKeys = new Set(Object.keys(schema));
+    const aliasMap = new Map();
+    // Build alias lookup
+    for (const [key, def] of Object.entries(schema)) {
+        if (def.aliases) {
+            def.aliases.forEach(alias => aliasMap.set(alias.toLowerCase(), key));
+        }
+    }
+    // Check for unknown or aliased options
+    for (const [key, value] of Object.entries(userOptions)) {
+        const lowerKey = key.toLowerCase();
+        if (validKeys.has(key)) {
+            // Valid key - validate type
+            const def = schema[key];
+            if (!validateType(value, def.type)) {
+                result.errors.push(`[${componentName}] Option "${key}" expects type "${def.type}", got "${typeof value}".`);
+                result.valid = false;
+            }
+            else {
+                result.normalized[key] = value;
+            }
+        }
+        else if (aliasMap.has(lowerKey)) {
+            // Found an alias - warn and normalize
+            const correctKey = aliasMap.get(lowerKey);
+            result.warnings.push(`[${componentName}] Option "${key}" is not valid. Did you mean "${correctKey}"?`);
+            result.normalized[correctKey] = value;
+        }
+        else {
+            // Unknown option
+            const suggestion = findClosestMatch(key, Array.from(validKeys));
+            const hint = suggestion ? ` Did you mean "${suggestion}"?` : '';
+            result.warnings.push(`[${componentName}] Unknown option "${key}".${hint} Valid options: ${Array.from(validKeys).join(', ')}`);
+        }
+    }
+    // Apply defaults for missing required options
+    for (const [key, def] of Object.entries(schema)) {
+        if (!(key in result.normalized)) {
+            if (def.required && def.default === undefined) {
+                result.errors.push(`[${componentName}] Required option "${key}" is missing.`);
+                result.valid = false;
+            }
+            else if (def.default !== undefined) {
+                result.normalized[key] = def.default;
+            }
+        }
+    }
+    // Log warnings/errors in debug mode
+    if (debugMode || result.warnings.length || result.errors.length) {
+        result.warnings.forEach(w => console.warn(w));
+        result.errors.forEach(e => console.error(e));
+    }
+    return result;
+}
+function validateType(value, expectedType) {
+    if (value === undefined || value === null)
+        return true; // Allow optional
+    switch (expectedType) {
+        case 'string': return typeof value === 'string';
+        case 'number': return typeof value === 'number';
+        case 'boolean': return typeof value === 'boolean';
+        case 'array': return Array.isArray(value);
+        case 'object': return typeof value === 'object' && !Array.isArray(value);
+        case 'function': return typeof value === 'function';
+        default: return true;
+    }
+}
+function findClosestMatch(input, candidates) {
+    const lower = input.toLowerCase();
+    let best = null;
+    let bestScore = Infinity;
+    for (const candidate of candidates) {
+        const score = levenshtein(lower, candidate.toLowerCase());
+        if (score < bestScore && score <= 3) { // Max 3 edits
+            bestScore = score;
+            best = candidate;
+        }
+    }
+    return best;
+}
+function levenshtein(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++)
+        matrix[i] = [i];
+    for (let j = 0; j <= a.length; j++)
+        matrix[0][j] = j;
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            matrix[i][j] = b[i - 1] === a[j - 1]
+                ? matrix[i - 1][j - 1]
+                : Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+        }
+    }
+    return matrix[b.length][a.length];
+}
+//# sourceMappingURL=OptionsContract.js.map

package/lib/componentsv2/base/OptionsContract.js.map

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

package/lib/componentsv2/base/OptionsContract.ts

@@ -0,0 +1,139 @@
+export interface OptionDefinition {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'function';
+    required?: boolean;
+    default?: any;
+    description?: string;
+    aliases?: string[]; // Common misspellings or alternate names
+}
+
+export type OptionsContractSchema = Record<string, OptionDefinition>;
+
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+    normalized: Record<string, any>;
+}
+
+/**
+ * Validates user-provided options against a defined contract schema.
+ * Emits warnings for unknown/misnamed options and errors for type mismatches.
+ */
+export function validateOptions<T extends Record<string, any>>(
+    componentName: string,
+    userOptions: Record<string, any>,
+    schema: OptionsContractSchema,
+    debugMode: boolean = false
+): ValidationResult {
+    const result: ValidationResult = {
+        valid: true,
+        warnings: [],
+        errors: [],
+        normalized: {}
+    };
+
+    const validKeys = new Set(Object.keys(schema));
+    const aliasMap = new Map<string, string>();
+
+    // Build alias lookup
+    for (const [key, def] of Object.entries(schema)) {
+        if (def.aliases) {
+            def.aliases.forEach(alias => aliasMap.set(alias.toLowerCase(), key));
+        }
+    }
+
+    // Check for unknown or aliased options
+    for (const [key, value] of Object.entries(userOptions)) {
+        const lowerKey = key.toLowerCase();
+
+        if (validKeys.has(key)) {
+            // Valid key - validate type
+            const def = schema[key];
+            if (!validateType(value, def.type)) {
+                result.errors.push(
+                    `[${componentName}] Option "${key}" expects type "${def.type}", got "${typeof value}".`
+                );
+                result.valid = false;
+            } else {
+                result.normalized[key] = value;
+            }
+        } else if (aliasMap.has(lowerKey)) {
+            // Found an alias - warn and normalize
+            const correctKey = aliasMap.get(lowerKey)!;
+            result.warnings.push(
+                `[${componentName}] Option "${key}" is not valid. Did you mean "${correctKey}"?`
+            );
+            result.normalized[correctKey] = value;
+        } else {
+            // Unknown option
+            const suggestion = findClosestMatch(key, Array.from(validKeys));
+            const hint = suggestion ? ` Did you mean "${suggestion}"?` : '';
+            result.warnings.push(
+                `[${componentName}] Unknown option "${key}".${hint} Valid options: ${Array.from(validKeys).join(', ')}`
+            );
+        }
+    }
+
+    // Apply defaults for missing required options
+    for (const [key, def] of Object.entries(schema)) {
+        if (!(key in result.normalized)) {
+            if (def.required && def.default === undefined) {
+                result.errors.push(`[${componentName}] Required option "${key}" is missing.`);
+                result.valid = false;
+            } else if (def.default !== undefined) {
+                result.normalized[key] = def.default;
+            }
+        }
+    }
+
+    // Log warnings/errors in debug mode
+    if (debugMode || result.warnings.length || result.errors.length) {
+        result.warnings.forEach(w => console.warn(w));
+        result.errors.forEach(e => console.error(e));
+    }
+
+    return result;
+}
+
+function validateType(value: any, expectedType: string): boolean {
+    if (value === undefined || value === null) return true; // Allow optional
+    switch (expectedType) {
+        case 'string': return typeof value === 'string';
+        case 'number': return typeof value === 'number';
+        case 'boolean': return typeof value === 'boolean';
+        case 'array': return Array.isArray(value);
+        case 'object': return typeof value === 'object' && !Array.isArray(value);
+        case 'function': return typeof value === 'function';
+        default: return true;
+    }
+}
+
+function findClosestMatch(input: string, candidates: string[]): string | null {
+    const lower = input.toLowerCase();
+    let best: string | null = null;
+    let bestScore = Infinity;
+
+    for (const candidate of candidates) {
+        const score = levenshtein(lower, candidate.toLowerCase());
+        if (score < bestScore && score <= 3) { // Max 3 edits
+            bestScore = score;
+            best = candidate;
+        }
+    }
+    return best;
+}
+
+function levenshtein(a: string, b: string): number {
+    const matrix: number[][] = [];
+    for (let i = 0; i <= b.length; i++) matrix[i] = [i];
+    for (let j = 0; j <= a.length; j++) matrix[0][j] = j;
+
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            matrix[i][j] = b[i - 1] === a[j - 1]
+                ? matrix[i - 1][j - 1]
+                : Math.min(matrix[i - 1][j - 1] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j] + 1);
+        }
+    }
+    return matrix[b.length][a.length];
+}

package/lib/componentsv2/element/component.d.ts

@@ -3,5 +3,27 @@ export type ElementComponent = ElementEngine & {
     render: (targetId: string | HTMLElement) => ElementComponent;
     injectCSS: (id: string, cssContent: string) => void;
 };
+/**
+ * OPTIONS CONTRACT for Element:
+ *
+ * | Option       | Type   | Default | Aliases                          |
+ * |--------------|--------|---------|----------------------------------|
+ * | tagName      | string | 'div'   | tag, element, type               |
+ * | content      | string | ''      | text, html, innerHTML, value     |
+ * | contentType  | string | 'text'  | type, mode                       |
+ * | inlineStyle  | string | ''      | style, css, styles               |
+ *
+ * METHODS (match state properties):
+ * - .tagName(value)     - Set HTML tag
+ * - .content(value, type) - Set content with type
+ * - .contentType(type)  - Set content type
+ * - .inlineStyle(css)   - Set inline styles
+ *
+ * CONVENIENCE ALIASES:
+ * - .tag(value)  → .tagName(value)
+ * - .text(value) → .content(value, 'text')
+ * - .html(value) → .content(value, 'html')
+ * - .style(css)  → .inlineStyle(css)
+ */
 export declare function Element(id: string, options?: ElementOptions): ElementComponent;
 //# sourceMappingURL=component.d.ts.map

package/lib/componentsv2/element/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC3C,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,KAAK,gBAAgB,CAAC;IAC7D,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,gBAAgB,CAuBlF"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC3C,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,KAAK,gBAAgB,CAAC;IAC7D,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,gBAAgB,CAuBlF"}

package/lib/componentsv2/element/component.js

@@ -1,5 +1,27 @@
 import { ElementEngine } from './engine.js';
 import { ElementSkin } from './skin.js';
+/**
+ * OPTIONS CONTRACT for Element:
+ *
+ * | Option       | Type   | Default | Aliases                          |
+ * |--------------|--------|---------|----------------------------------|
+ * | tagName      | string | 'div'   | tag, element, type               |
+ * | content      | string | ''      | text, html, innerHTML, value     |
+ * | contentType  | string | 'text'  | type, mode                       |
+ * | inlineStyle  | string | ''      | style, css, styles               |
+ *
+ * METHODS (match state properties):
+ * - .tagName(value)     - Set HTML tag
+ * - .content(value, type) - Set content with type
+ * - .contentType(type)  - Set content type
+ * - .inlineStyle(css)   - Set inline styles
+ *
+ * CONVENIENCE ALIASES:
+ * - .tag(value)  → .tagName(value)
+ * - .text(value) → .content(value, 'text')
+ * - .html(value) → .content(value, 'html')
+ * - .style(css)  → .inlineStyle(css)
+ */
 export function Element(id, options = {}) {
     const engine = new ElementEngine(id, options);
     if (typeof window !== 'undefined') {

package/lib/componentsv2/element/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,UAA0B,EAAE;IAC5D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,aAAa;QACb,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC5C,aAAa;QACb,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAErC,aAAa;IACb,MAAM,CAAC,MAAM,GAAG,CAAC,QAA8B,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3F,IAAI,MAAM;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,MAA0B,CAAC;IACtC,CAAC,CAAC;IAEF,aAAa;IACb,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAExD,OAAO,MAA0B,CAAC;AACtC,CAAC"}
+{"version":3,"file":"component.js","sourceRoot":"","sources":["component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAOxC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,UAA0B,EAAE;IAC5D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAE9C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,aAAa;QACb,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC5C,aAAa;QACb,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAErC,aAAa;IACb,MAAM,CAAC,MAAM,GAAG,CAAC,QAA8B,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3F,IAAI,MAAM;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,MAA0B,CAAC;IACtC,CAAC,CAAC;IAEF,aAAa;IACb,MAAM,CAAC,SAAS,GAAG,CAAC,EAAU,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAExE,OAAO,MAA0B,CAAC;AACtC,CAAC"}

package/lib/componentsv2/element/component.ts

@@ -6,6 +6,28 @@ export type ElementComponent = ElementEngine & {
     injectCSS: (id: string, cssContent: string) => void;
 };
 
+/**
+ * OPTIONS CONTRACT for Element:
+ * 
+ * | Option       | Type   | Default | Aliases                          |
+ * |--------------|--------|---------|----------------------------------|
+ * | tagName      | string | 'div'   | tag, element, type               |
+ * | content      | string | ''      | text, html, innerHTML, value     |
+ * | contentType  | string | 'text'  | type, mode                       |
+ * | inlineStyle  | string | ''      | style, css, styles               |
+ * 
+ * METHODS (match state properties):
+ * - .tagName(value)     - Set HTML tag
+ * - .content(value, type) - Set content with type
+ * - .contentType(type)  - Set content type
+ * - .inlineStyle(css)   - Set inline styles
+ * 
+ * CONVENIENCE ALIASES:
+ * - .tag(value)  → .tagName(value)
+ * - .text(value) → .content(value, 'text')
+ * - .html(value) → .content(value, 'html')
+ * - .style(css)  → .inlineStyle(css)
+ */
 export function Element(id: string, options: ElementOptions = {}): ElementComponent {
     const engine = new ElementEngine(id, options);
 
@@ -26,7 +48,7 @@ export function Element(id: string, options: ElementOptions = {}): ElementCompon
     };
 
     // @ts-ignore
-    engine.injectCSS = (id, css) => skin.injectCSS(id, css);
+    engine.injectCSS = (id: string, css: string) => skin.injectCSS(id, css);
 
     return engine as ElementComponent;
 }

package/lib/componentsv2/element/engine.d.ts

@@ -1,4 +1,5 @@
 import { BaseEngine, BaseState } from '../base/BaseEngine.js';
+import { OptionsContractSchema } from '../base/OptionsContract.js';
 export interface ElementState extends BaseState {
     tagName: string;
     content: string | null;
@@ -6,37 +7,53 @@ export interface ElementState extends BaseState {
     inlineStyle: string;
 }
 export interface ElementOptions {
-    tag?: string;
-    text?: string;
-    html?: string;
-    style?: string;
+    tagName?: string;
+    content?: string;
+    contentType?: 'text' | 'html';
+    inlineStyle?: string;
 }
 export declare class ElementEngine extends BaseEngine<ElementState, ElementOptions> {
     constructor(id: string, options?: ElementOptions);
+    /**
+     * OPTIONS CONTRACT
+     * Defines valid options with types, defaults, and aliases for common mistakes.
+     */
+    protected get optionsSchema(): OptionsContractSchema;
     protected prepareState(id: string, options: ElementOptions): ElementState;
     /**
-     * Set the HTML Tag name (e.g. 'div', 'span', 'h1', 'section')
+     * Set the HTML tag name (e.g., 'div', 'span', 'h1', 'section')
+     * Method name matches state property: tagName
      */
-    tag(tagName: string): this;
+    tagName(value: string): this;
     /**
-     * Set plain text content (automatically escaped)
+     * Set content with explicit type
+     * Method name matches state property: content
      */
-    text(value: string): this;
+    content(value: string, type?: 'text' | 'html'): this;
+    /**
+     * Set content type
+     * Method name matches state property: contentType
+     */
+    contentType(type: 'text' | 'html'): this;
     /**
-     * Set raw HTML content (innerHTML)
+     * Set inline styles (e.g., "color: red; margin: 10px;")
+     * Method name matches state property: inlineStyle
      */
+    inlineStyle(cssText: string): this;
+    /** @alias for tagName() */
+    tag(value: string): this;
+    /** @alias for content(value, 'text') */
+    text(value: string): this;
+    /** @alias for content(value, 'html') */
     html(value: string): this;
+    /** @alias for inlineStyle() */
+    style(cssText: string): this;
     /**
      * Append raw HTML to existing content
      */
     appendHtml(value: string): this;
-    /**
-     * Set inline styles (e.g. "color: red; margin: 10px;")
-     */
-    style(cssText: string): this;
     /**
      * Receives RAW DOM events from the Skin and emits them to listeners.
-     * This keeps the 'emit' logic encapsulated within the Engine.
      */
     handleEvent(eventName: string, content: any): void;
 }