@solidxai/core 0.1.10-beta.21 → 0.1.10-beta.23

package/dist/testing/adapters/ui/playwright-adapter.js

@@ -42,6 +42,9 @@ class PlaywrightAdapter {
         this.baseUrl = opts?.baseUrl;
         this.headless = opts?.headless ?? true;
     }
+    isHeadless() {
+        return this.headless;
+    }
     async start() {
         const { chromium } = await Promise.resolve().then(() => __importStar(require('playwright')));
         this.browser = await chromium.launch({ headless: this.headless });

package/dist/testing/adapters/ui/playwright-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-adapter.js","sourceRoot":"","sources":["../../../../src/testing/adapters/ui/playwright-adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAa,iBAAiB;IAO5B,YAAY,IAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,YAAY,GAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACxB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA7CD,8CA6CC","sourcesContent":["import type { Browser, BrowserContext, Page } from \"playwright\";\n\nimport type { PlaywrightAdapterOptions } from \"./ui.types\";\n\nfunction isAbsoluteUrl(url: string): boolean {\n  return /^https?:\\/\\//i.test(url);\n}\n\nexport class PlaywrightAdapter {\n  private readonly baseUrl?: string;\n  private readonly headless: boolean;\n  private browser?: Browser;\n  private context?: BrowserContext;\n  public page?: Page;\n\n  constructor(opts?: PlaywrightAdapterOptions) {\n    this.baseUrl = opts?.baseUrl;\n    this.headless = opts?.headless ?? true;\n  }\n\n  async start(): Promise<void> {\n    const { chromium } = await import('playwright');\n    this.browser = await chromium.launch({ headless: this.headless });\n    this.context = await this.browser.newContext();\n    this.page = await this.context.newPage();\n  }\n\n  async stop(): Promise<void> {\n    try {\n      if (this.context) {\n        await this.context.close();\n      }\n    } finally {\n      this.context = undefined;\n      this.page = undefined;\n    }\n\n    try {\n      if (this.browser) {\n        await this.browser.close();\n      }\n    } finally {\n      this.browser = undefined;\n    }\n  }\n\n  resolveUrl(url: string): string {\n    if (isAbsoluteUrl(url)) return url;\n    if (this.baseUrl) {\n      return new URL(url, this.baseUrl).toString();\n    }\n    return url;\n  }\n}\n"]}
+{"version":3,"file":"playwright-adapter.js","sourceRoot":"","sources":["../../../../src/testing/adapters/ui/playwright-adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAS,aAAa,CAAC,GAAW;IAChC,OAAO,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAa,iBAAiB;IAO5B,YAAY,IAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC;IACzC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,QAAQ,EAAE,GAAG,wDAAa,YAAY,GAAC,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACxB,CAAC;QAED,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAjDD,8CAiDC","sourcesContent":["import type { Browser, BrowserContext, Page } from \"playwright\";\n\nimport type { PlaywrightAdapterOptions } from \"./ui.types\";\n\nfunction isAbsoluteUrl(url: string): boolean {\n  return /^https?:\\/\\//i.test(url);\n}\n\nexport class PlaywrightAdapter {\n  private readonly baseUrl?: string;\n  private readonly headless: boolean;\n  private browser?: Browser;\n  private context?: BrowserContext;\n  public page?: Page;\n\n  constructor(opts?: PlaywrightAdapterOptions) {\n    this.baseUrl = opts?.baseUrl;\n    this.headless = opts?.headless ?? true;\n  }\n\n  isHeadless(): boolean {\n    return this.headless;\n  }\n\n  async start(): Promise<void> {\n    const { chromium } = await import('playwright');\n    this.browser = await chromium.launch({ headless: this.headless });\n    this.context = await this.browser.newContext();\n    this.page = await this.context.newPage();\n  }\n\n  async stop(): Promise<void> {\n    try {\n      if (this.context) {\n        await this.context.close();\n      }\n    } finally {\n      this.context = undefined;\n      this.page = undefined;\n    }\n\n    try {\n      if (this.browser) {\n        await this.browser.close();\n      }\n    } finally {\n      this.browser = undefined;\n    }\n  }\n\n  resolveUrl(url: string): string {\n    if (isAbsoluteUrl(url)) return url;\n    if (this.baseUrl) {\n      return new URL(url, this.baseUrl).toString();\n    }\n    return url;\n  }\n}\n"]}

package/dist/testing/steps/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAK5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAOxD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAM5D"}

package/dist/testing/steps/ui/index.js

@@ -5,10 +5,12 @@ const navigation_step_1 = require("./navigation.step");
 const form_step_1 = require("./form.step");
 const actions_step_1 = require("./actions.step");
 const assertions_step_1 = require("./assertions.step");
+const manual_step_1 = require("./manual.step");
 function registerUiSteps(registry) {
     (0, navigation_step_1.registerNavigationSteps)(registry);
     (0, form_step_1.registerFormSteps)(registry);
     (0, actions_step_1.registerActionSteps)(registry);
     (0, assertions_step_1.registerAssertionSteps)(registry);
+    (0, manual_step_1.registerManualSteps)(registry);
 }
 //# sourceMappingURL=index.js.map

package/dist/testing/steps/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/index.ts"],"names":[],"mappings":";;AAMA,0CAKC;AAVD,uDAA4D;AAC5D,2CAAgD;AAChD,iDAAqD;AACrD,uDAA2D;AAE3D,SAAgB,eAAe,CAAC,QAAsB;IACpD,IAAA,yCAAuB,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5B,IAAA,kCAAmB,EAAC,QAAQ,CAAC,CAAC;IAC9B,IAAA,wCAAsB,EAAC,QAAQ,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { StepRegistry } from \"../../core/step-registry\";\nimport { registerNavigationSteps } from \"./navigation.step\";\nimport { registerFormSteps } from \"./form.step\";\nimport { registerActionSteps } from \"./actions.step\";\nimport { registerAssertionSteps } from \"./assertions.step\";\n\nexport function registerUiSteps(registry: StepRegistry): void {\n  registerNavigationSteps(registry);\n  registerFormSteps(registry);\n  registerActionSteps(registry);\n  registerAssertionSteps(registry);\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/index.ts"],"names":[],"mappings":";;AAOA,0CAMC;AAZD,uDAA4D;AAC5D,2CAAgD;AAChD,iDAAqD;AACrD,uDAA2D;AAC3D,+CAAoD;AAEpD,SAAgB,eAAe,CAAC,QAAsB;IACpD,IAAA,yCAAuB,EAAC,QAAQ,CAAC,CAAC;IAClC,IAAA,6BAAiB,EAAC,QAAQ,CAAC,CAAC;IAC5B,IAAA,kCAAmB,EAAC,QAAQ,CAAC,CAAC;IAC9B,IAAA,wCAAsB,EAAC,QAAQ,CAAC,CAAC;IACjC,IAAA,iCAAmB,EAAC,QAAQ,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import { StepRegistry } from \"../../core/step-registry\";\nimport { registerNavigationSteps } from \"./navigation.step\";\nimport { registerFormSteps } from \"./form.step\";\nimport { registerActionSteps } from \"./actions.step\";\nimport { registerAssertionSteps } from \"./assertions.step\";\nimport { registerManualSteps } from \"./manual.step\";\n\nexport function registerUiSteps(registry: StepRegistry): void {\n  registerNavigationSteps(registry);\n  registerFormSteps(registry);\n  registerActionSteps(registry);\n  registerAssertionSteps(registry);\n  registerManualSteps(registry);\n}\n"]}

package/dist/testing/steps/ui/manual.step.d.ts

@@ -0,0 +1,3 @@
+import { StepRegistry } from "../../core/step-registry";
+export declare function registerManualSteps(registry: StepRegistry): void;
+//# sourceMappingURL=manual.step.d.ts.map

package/dist/testing/steps/ui/manual.step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.step.d.ts","sourceRoot":"","sources":["../../../../src/testing/steps/ui/manual.step.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAmBxD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAuDhE"}

package/dist/testing/steps/ui/manual.step.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerManualSteps = registerManualSteps;
+const promises_1 = require("node:readline/promises");
+const node_process_1 = require("node:process");
+function requirePage(ctx, op) {
+    if (!ctx.ui || !ctx.ui.page) {
+        throw new Error(`Missing UI page on context for op "${op}"`);
+    }
+    return ctx.ui.page;
+}
+function registerManualSteps(registry) {
+    registry.register("ui.waitForManual", async (ctx, step) => {
+        const page = requirePage(ctx, "ui.waitForManual");
+        const inputConfig = (step.with ?? {});
+        const message = inputConfig.message?.trim() || "Manual interaction required.";
+        const prompt = inputConfig.prompt?.trim() || "Press Enter to continue...";
+        const timeoutMs = inputConfig.timeoutMs;
+        const bringToFront = inputConfig.bringToFront ?? true;
+        if (ctx.ui?.isHeadless()) {
+            throw new Error('Op "ui.waitForManual" requires headed mode. Re-run with --headless false.');
+        }
+        if (!node_process_1.stdin.isTTY || !node_process_1.stdout.isTTY) {
+            throw new Error('Op "ui.waitForManual" requires an interactive terminal (TTY).');
+        }
+        if (bringToFront) {
+            await page.bringToFront();
+        }
+        console.log("");
+        console.log("════════ Manual Interaction Required ════════");
+        console.log(message);
+        console.log(`Scenario: ${ctx.scenarioId}`);
+        console.log(`Current URL: ${page.url()}`);
+        console.log(prompt);
+        const rl = (0, promises_1.createInterface)({ input: node_process_1.stdin, output: node_process_1.stdout });
+        try {
+            await rl.question("");
+        }
+        finally {
+            rl.close();
+        }
+        if (inputConfig.waitForSelector) {
+            await page.waitForSelector(inputConfig.waitForSelector, {
+                state: "visible",
+                timeout: timeoutMs,
+            });
+        }
+        if (inputConfig.waitForUrlEquals) {
+            await page.waitForURL((url) => url.toString() === inputConfig.waitForUrlEquals, { timeout: timeoutMs });
+        }
+        if (inputConfig.waitForUrlContains) {
+            await page.waitForURL((url) => url.toString().includes(String(inputConfig.waitForUrlContains)), { timeout: timeoutMs });
+        }
+    });
+}
+//# sourceMappingURL=manual.step.js.map

package/dist/testing/steps/ui/manual.step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual.step.js","sourceRoot":"","sources":["../../../../src/testing/steps/ui/manual.step.ts"],"names":[],"mappings":";;AAwBA,kDAuDC;AA/ED,qDAAyD;AACzD,+CAAgE;AAgBhE,SAAS,WAAW,CAAC,GAAgB,EAAE,EAAU;IAC/C,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,SAAgB,mBAAmB,CAAC,QAAsB;IACxD,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAgB,EAAE,IAAY,EAAE,EAAE;QAC7E,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAuB,CAAC;QAC5D,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,8BAA8B,CAAC;QAC9E,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,4BAA4B,CAAC;QAC1E,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACxC,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,IAAI,IAAI,CAAC;QAEtD,IAAI,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,oBAAK,CAAC,KAAK,IAAI,CAAC,qBAAM,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,MAAM,EAAE,GAAG,IAAA,0BAAe,EAAC,EAAE,KAAK,EAAL,oBAAK,EAAE,MAAM,EAAN,qBAAM,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QAED,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,eAAe,EAAE;gBACtD,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,SAAS;aACnB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,IAAI,CAAC,UAAU,CACnB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,WAAW,CAAC,gBAAgB,EACxD,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,kBAAkB,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,UAAU,CACnB,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,EACxE,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { createInterface } from \"node:readline/promises\";\nimport { stdin as input, stdout as output } from \"node:process\";\n\nimport type { TestContext } from \"../../contracts/runtime-context.types\";\nimport type { OpStep } from \"../../contracts/testing-metadata.types\";\nimport { StepRegistry } from \"../../core/step-registry\";\n\ntype WaitForManualInput = {\n  message?: string;\n  prompt?: string;\n  waitForSelector?: string;\n  waitForUrlContains?: string;\n  waitForUrlEquals?: string;\n  timeoutMs?: number;\n  bringToFront?: boolean;\n};\n\nfunction requirePage(ctx: TestContext, op: string) {\n  if (!ctx.ui || !ctx.ui.page) {\n    throw new Error(`Missing UI page on context for op \"${op}\"`);\n  }\n  return ctx.ui.page;\n}\n\nexport function registerManualSteps(registry: StepRegistry): void {\n  registry.register(\"ui.waitForManual\", async (ctx: TestContext, step: OpStep) => {\n    const page = requirePage(ctx, \"ui.waitForManual\");\n    const inputConfig = (step.with ?? {}) as WaitForManualInput;\n    const message = inputConfig.message?.trim() || \"Manual interaction required.\";\n    const prompt = inputConfig.prompt?.trim() || \"Press Enter to continue...\";\n    const timeoutMs = inputConfig.timeoutMs;\n    const bringToFront = inputConfig.bringToFront ?? true;\n\n    if (ctx.ui?.isHeadless()) {\n      throw new Error('Op \"ui.waitForManual\" requires headed mode. Re-run with --headless false.');\n    }\n    if (!input.isTTY || !output.isTTY) {\n      throw new Error('Op \"ui.waitForManual\" requires an interactive terminal (TTY).');\n    }\n\n    if (bringToFront) {\n      await page.bringToFront();\n    }\n\n    console.log(\"\");\n    console.log(\"════════ Manual Interaction Required ════════\");\n    console.log(message);\n    console.log(`Scenario: ${ctx.scenarioId}`);\n    console.log(`Current URL: ${page.url()}`);\n    console.log(prompt);\n\n    const rl = createInterface({ input, output });\n    try {\n      await rl.question(\"\");\n    } finally {\n      rl.close();\n    }\n\n    if (inputConfig.waitForSelector) {\n      await page.waitForSelector(inputConfig.waitForSelector, {\n        state: \"visible\",\n        timeout: timeoutMs,\n      });\n    }\n\n    if (inputConfig.waitForUrlEquals) {\n      await page.waitForURL(\n        (url) => url.toString() === inputConfig.waitForUrlEquals,\n        { timeout: timeoutMs },\n      );\n    }\n\n    if (inputConfig.waitForUrlContains) {\n      await page.waitForURL(\n        (url) => url.toString().includes(String(inputConfig.waitForUrlContains)),\n        { timeout: timeoutMs },\n      );\n    }\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidxai/core",
-  "version": "0.1.10-beta.21",
+  "version": "0.1.10-beta.23",
   "description": "This module is a NestJS module containing all the required core providers required by a Solid application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/commands/info.command.ts

@@ -53,8 +53,6 @@ export class InfoCommand extends CommandRunner {
             selectionProviders: this.getWrapperNames(this.solidRegistry.getSelectionProviders()),
             computedFieldProviders: this.getWrapperNames(this.solidRegistry.getComputedFieldProviders()),
             solidDatabaseModules: this.getWrapperNames(this.solidRegistry.getSolidDatabaseModules()),
-            dashboardVariableSelectionProviders: this.getWrapperNames(this.solidRegistry.getDashboardVariableSelectionProviders()),
-            dashboardQuestionDataProviders: this.getWrapperNames(this.solidRegistry.getDashboardQuestionDataProviders()),
             mailProviders: this.getWrapperNames(this.solidRegistry.getMailProviders()),
             whatsappProviders: this.getWrapperNames(this.solidRegistry.getWhatsappProviders()),
             smsProviders: this.getWrapperNames(this.solidRegistry.getSmsProviders()),

package/src/controllers/{dashboard-variable.controller.ts → dashboard-user-layout.controller.ts}

@@ -1,9 +1,9 @@
 import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
 import { AnyFilesInterceptor } from "@nestjs/platform-express";
 import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
-import { DashboardVariableService } from '../services/dashboard-variable.service';
-import { CreateDashboardVariableDto } from '../dtos/create-dashboard-variable.dto';
-import { UpdateDashboardVariableDto } from '../dtos/update-dashboard-variable.dto';
+import { DashboardUserLayoutService } from '../services/dashboard-user-layout.service';
+import { CreateDashboardUserLayoutDto } from '../dtos/create-dashboard-user-layout.dto';
+import { UpdateDashboardUserLayoutDto } from '../dtos/update-dashboard-user-layout.dto';
 
 enum ShowSoftDeleted {
   INCLUSIVE = "inclusive",
@@ -11,21 +11,21 @@ enum ShowSoftDeleted {
 }
 
 @ApiTags('Solid Core')
-@Controller('dashboard-variable')
-export class DashboardVariableController {
-  constructor(private readonly service: DashboardVariableService) {}
+@Controller('dashboard-user-layout')
+export class DashboardUserLayoutController {
+  constructor(private readonly service: DashboardUserLayoutService) {}
 
   @ApiBearerAuth("jwt")
   @Post()
   @UseInterceptors(AnyFilesInterceptor())
-  create(@Body() createDto: CreateDashboardVariableDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+  create(@Body() createDto: CreateDashboardUserLayoutDto, @UploadedFiles() files: Array<Express.Multer.File>) {
     return this.service.create(createDto, files);
   }
 
   @ApiBearerAuth("jwt")
   @Post('/bulk')
   @UseInterceptors(AnyFilesInterceptor())
-  insertMany(@Body() createDtos: CreateDashboardVariableDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+  insertMany(@Body() createDtos: CreateDashboardUserLayoutDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
     return this.service.insertMany(createDtos, filesArray);
   }
 
@@ -33,14 +33,14 @@ export class DashboardVariableController {
   @ApiBearerAuth("jwt")
   @Put(':id')
   @UseInterceptors(AnyFilesInterceptor())
-  update(@Param('id') id: number, @Body() updateDto: UpdateDashboardVariableDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+  update(@Param('id') id: number, @Body() updateDto: UpdateDashboardUserLayoutDto, @UploadedFiles() files: Array<Express.Multer.File>) {
     return this.service.update(id, updateDto, files);
   }
 
   @ApiBearerAuth("jwt")
   @Patch(':id')
   @UseInterceptors(AnyFilesInterceptor())
-  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateDashboardVariableDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateDashboardUserLayoutDto, @UploadedFiles() files: Array<Express.Multer.File>) {
     return this.service.update(id, updateDto, files, true);
   }
 

package/src/controllers/dashboard.controller.ts

@@ -1,99 +1,80 @@
-import { Body, Controller, Delete, Get, Param, Patch, Post, Put, Query, UploadedFiles, UseInterceptors } from '@nestjs/common';
-import { AnyFilesInterceptor } from "@nestjs/platform-express";
-import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
-import { DashboardVariableSelectionDynamicQueryDto } from 'src/dtos/dashboard-variable-selection-dynamic-query.dto';
-import { CreateDashboardDto } from '../dtos/create-dashboard.dto';
-import { UpdateDashboardDto } from '../dtos/update-dashboard.dto';
-import { DashboardService } from '../services/dashboard.service';
+import { Body, Controller, Get, Param, Post, Put, Query } from '@nestjs/common';
+import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
+import { ActiveUser } from 'src/decorators/active-user.decorator';
+import { DashboardVariableOptionsQueryDto } from 'src/dtos/dashboard-variable-options-query.dto';
+import { DashboardBatchDataRequestDto, DashboardSaveLayoutDto, DashboardWidgetDataRequestDto } from 'src/dtos/dashboard-widget-data-request.dto';
+import { ActiveUserData } from 'src/interfaces/active-user-data.interface';
+import { DashboardRuntimeService } from 'src/services/dashboard-runtime.service';
 
-enum ShowSoftDeleted {
-  INCLUSIVE = "inclusive",
-  EXCLUSIVE = "exclusive",
-}
-
-@ApiTags('Solid Core')
 @Controller('dashboard')
+@ApiTags('Solid Core')
 export class DashboardController {
-  constructor(private readonly service: DashboardService) { }
-
-  @ApiBearerAuth("jwt")
-  @Post()
-  @UseInterceptors(AnyFilesInterceptor())
-  create(@Body() createDto: CreateDashboardDto, @UploadedFiles() files: Array<Express.Multer.File>) {
-    return this.service.create(createDto, files);
-  }
-
-  @ApiBearerAuth("jwt")
-  @Post('/bulk')
-  @UseInterceptors(AnyFilesInterceptor())
-  insertMany(@Body() createDtos: CreateDashboardDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
-    return this.service.insertMany(createDtos, filesArray);
-  }
+    constructor(
+        private readonly dashboardRuntimeService: DashboardRuntimeService,
+    ) { }
 
+    @ApiBearerAuth('jwt')
+    @Get(':moduleName/:dashboardName/definition')
+    async getDefinition(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+    ) {
+        return this.dashboardRuntimeService.getDashboardDefinition(moduleName, dashboardName);
+    }
 
-  @ApiBearerAuth("jwt")
-  @Put(':id')
-  @UseInterceptors(AnyFilesInterceptor())
-  update(@Param('id') id: number, @Body() updateDto: UpdateDashboardDto, @UploadedFiles() files: Array<Express.Multer.File>) {
-    return this.service.update(id, updateDto, files);
-  }
+    @ApiBearerAuth('jwt')
+    @Post(':moduleName/:dashboardName/widgets/:widgetName/data')
+    async getWidgetData(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+        @Param('widgetName') widgetName: string,
+        @Body() request: DashboardWidgetDataRequestDto,
+        @ActiveUser() activeUser: ActiveUserData,
+    ) {
+        return this.dashboardRuntimeService.getWidgetData(moduleName, dashboardName, widgetName, request, activeUser);
+    }
 
-  @ApiBearerAuth("jwt")
-  @Patch(':id')
-  @UseInterceptors(AnyFilesInterceptor())
-  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateDashboardDto, @UploadedFiles() files: Array<Express.Multer.File>) {
-    return this.service.update(id, updateDto, files, true);
-  }
+    @ApiBearerAuth('jwt')
+    @Post(':moduleName/:dashboardName/data')
+    async getDashboardData(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+        @Body() request: DashboardBatchDataRequestDto,
+        @ActiveUser() activeUser: ActiveUserData,
+    ) {
+        return this.dashboardRuntimeService.getDashboardData(moduleName, dashboardName, request, activeUser);
+    }
 
-  @ApiBearerAuth("jwt")
-  @Post('/bulk-recover')
-  async recoverMany(@Body() ids: number[]) {
-    return this.service.recoverMany(ids);
-  }
+    @ApiBearerAuth('jwt')
+    @Get(':moduleName/:dashboardName/variable-options/:variableName')
+    async getVariableOptions(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+        @Param('variableName') variableName: string,
+        @Query() query: DashboardVariableOptionsQueryDto,
+    ) {
+        return this.dashboardRuntimeService.getVariableOptions(moduleName, dashboardName, variableName, query);
+    }
 
-  @ApiBearerAuth("jwt")
-  @Get('/recover/:id')
-  async recover(@Param('id') id: number) {
-    return this.service.recover(id);
-  }
-
-  @ApiBearerAuth("jwt")
-  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
-  @ApiQuery({ name: 'limit', required: false, type: Number })
-  @ApiQuery({ name: 'offset', required: false, type: Number })
-  @ApiQuery({ name: 'fields', required: false, type: Array })
-  @ApiQuery({ name: 'sort', required: false, type: Array })
-  @ApiQuery({ name: 'groupBy', required: false, type: Array })
-  @ApiQuery({ name: 'populate', required: false, type: Array })
-  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
-  @ApiQuery({ name: 'filters', required: false, type: Array })
-  @Get()
-  async findMany(@Query() query: any) {
-    return this.service.find(query);
-  }
-
-  @ApiBearerAuth("jwt")
-  @Get('/selection-dynamic-values')
-  async getSelectionDynamicValues(@Query() query: DashboardVariableSelectionDynamicQueryDto) {
-    return this.service.getSelectionDynamicValues(query);
-  }
-
-  @ApiBearerAuth("jwt")
-  @Get(':id')
-  async findOne(@Param('id') id: string, @Query() query: any) {
-    return this.service.findOne(+id, query);
-  }
-
-  @ApiBearerAuth("jwt")
-  @Delete('/bulk')
-  async deleteMany(@Body() ids: number[]) {
-    return this.service.deleteMany(ids);
-  }
-
-  @ApiBearerAuth("jwt")
-  @Delete(':id')
-  async delete(@Param('id') id: number) {
-    return this.service.delete(id);
-  }
+    @ApiBearerAuth('jwt')
+    @Get(':moduleName/:dashboardName/layout')
+    async getLayout(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+        @ActiveUser() activeUser: ActiveUserData,
+    ) {
+        return this.dashboardRuntimeService.getLayout(moduleName, dashboardName, activeUser);
+    }
 
+    @ApiBearerAuth('jwt')
+    @Put(':moduleName/:dashboardName/layout')
+    async saveLayout(
+        @Param('moduleName') moduleName: string,
+        @Param('dashboardName') dashboardName: string,
+        @Body() body: DashboardSaveLayoutDto,
+        @ActiveUser() activeUser: ActiveUserData,
+    ) {
+        return this.dashboardRuntimeService.saveLayout(moduleName, dashboardName, body, activeUser);
+    }
 }
+

package/src/decorators/dashboard-widget-data-provider.decorator.ts

@@ -0,0 +1,6 @@
+import { SetMetadata } from "@nestjs/common";
+
+export const IS_DASHBOARD_WIDGET_DATA_PROVIDER = "IS_DASHBOARD_WIDGET_DATA_PROVIDER";
+
+export const DashboardWidgetDataProvider = () => SetMetadata(IS_DASHBOARD_WIDGET_DATA_PROVIDER, true);
+

package/src/dtos/create-dashboard-user-layout.dto.ts

@@ -0,0 +1,41 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsInt } from 'class-validator';
+import { IsOptional } from 'class-validator';
+import { IsString, IsNotEmpty } from 'class-validator';
+
+export class CreateDashboardUserLayoutDto {
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    userId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty()
+    userUserKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    moduleId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty()
+    moduleUserKey: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty()
+    dashboardName: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty()
+    layoutJson: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    version: number;
+}

package/src/dtos/dashboard-variable-options-query.dto.ts

@@ -0,0 +1,20 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsOptional, IsString } from "class-validator";
+import { PaginationQueryDto } from "src/dtos/pagination-query.dto";
+
+export class DashboardVariableOptionsQueryDto extends PaginationQueryDto {
+    @ApiProperty({ description: "Search query string", type: String, required: false })
+    @IsString()
+    @IsOptional()
+    query?: string;
+
+    @ApiProperty({ description: "Single option value", type: String, required: false })
+    @IsString()
+    @IsOptional()
+    optionValue?: string;
+
+    @ApiProperty({ description: "Form values object serialized as JSON or querystring", required: false })
+    @IsOptional()
+    formValues?: Record<string, any> | string;
+}
+

package/src/dtos/dashboard-widget-data-request.dto.ts

@@ -0,0 +1,34 @@
+import { ApiProperty } from "@nestjs/swagger";
+import { IsArray, IsObject, IsOptional, IsString } from "class-validator";
+
+export class DashboardWidgetDataRequestDto {
+    @ApiProperty({ description: "Runtime variable values", type: Object, required: false })
+    @IsOptional()
+    @IsObject()
+    variables?: Record<string, any>;
+
+    @ApiProperty({ description: "Optional provider context overrides", type: Object, required: false })
+    @IsOptional()
+    @IsObject()
+    providerContext?: Record<string, any>;
+}
+
+export class DashboardBatchDataRequestDto extends DashboardWidgetDataRequestDto {
+    @ApiProperty({ description: "Subset of widget ids/names to evaluate", type: [String], required: false })
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    widgetNames?: string[];
+}
+
+export class DashboardSaveLayoutDto {
+    @ApiProperty({ description: "Grid/layout payload from UI", type: Object })
+    layoutJson: Record<string, any> | any[];
+
+    @ApiProperty({
+        description: "Backward-compatible alias for layoutJson.",
+        type: Object,
+        required: false,
+    })
+    layout?: Record<string, any> | any[];
+}

package/src/dtos/update-dashboard-user-layout.dto.ts

@@ -0,0 +1,45 @@
+import { IsInt,IsOptional, IsString, IsNotEmpty } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class UpdateDashboardUserLayoutDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    userId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty()
+    userUserKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    moduleId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty()
+    moduleUserKey: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty()
+    dashboardName: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty()
+    layoutJson: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty()
+    version: number;
+}

package/src/entities/dashboard-user-layout.entity.ts

@@ -0,0 +1,27 @@
+import { CommonEntity } from 'src/entities/common.entity';
+import { Entity, JoinColumn, ManyToOne, Index, Column } from 'typeorm';
+import { User } from 'src/entities/user.entity';
+import { ModuleMetadata } from 'src/entities/module-metadata.entity'
+
+@Entity('ss_dashboard_user_layout')
+export class DashboardUserLayout extends CommonEntity {
+    @Index()
+    @ManyToOne(() => User, { onDelete: "CASCADE", nullable: false })
+    @JoinColumn()
+    user: User;
+
+    @Index()
+    @ManyToOne(() => ModuleMetadata, { onDelete: "CASCADE", nullable: false })
+    @JoinColumn()
+    module: ModuleMetadata;
+
+    @Index()
+    @Column({ name: "dashboard_name", type: "varchar" })
+    dashboardName: string;
+
+    @Column({ name: "layout_json", type: "text" })
+    layoutJson: string;
+
+    @Column({ type: "integer", nullable: true })
+    version: number;
+}

package/src/helpers/bootstrap.helper.ts

@@ -188,7 +188,7 @@ export async function bootstrapSolidApp(
   app.useLogger(app.get(WINSTON_MODULE_NEST_PROVIDER));
 
   const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
-  app.get(WINSTON_MODULE_NEST_PROVIDER).log(`\x1b[32mServer started on port ${port} in ${elapsed}s\x1b[0m`, 'Bootstrap');
+  process.stdout.write(`\x1b[32mServer started on port ${port} in ${elapsed}s\x1b[0m\n`);
 }
 
 // ---- CLI bootstrap ----

package/src/helpers/field-crud-managers/field-quality-check-fixes.md

@@ -155,24 +155,54 @@ Frontend widget and rendering concerns belong in `solid-core-ui`.
 
 ## `many-to-one`
 
-- [ ] Review pending.
+- [ ] Clarify and document the preferred request contract for single relations, because accepting both `<fieldName>Id` and `<fieldName>UserKey` is useful but easy to apply inconsistently across clients.
+- [ ] Review whether the CRUD layer should normalize empty strings for `<fieldName>Id` and `<fieldName>UserKey` more explicitly before required validation runs.
+- [ ] Decide whether user-key-based lookup failures should return a more specific error message than generic required or invalid relation errors.
+- [ ] Review whether relation resolution should support optional fixed-filter enforcement at save time in addition to UI-level filtering.
+- [ ] Consider whether uniqueness on a `many-to-one` field should receive clearer pre-save validation when the authored intent effectively makes the relation one-to-one.
+- [ ] Add targeted coverage for id-based lookup, user-key-based lookup, missing required relations, invalid id shapes, invalid user keys, and partial update behavior.
 
 ## `one-to-many`
 
-- [ ] Review pending.
+- [ ] Clarify and document the command contract for collection relations so `set`, `clear`, `link`, `unlink`, `create`, `update`, and `delete` are easier to use consistently from clients.
+- [ ] Review whether malformed or unsupported command values should return more specific validation errors than the current generic failure path.
+- [ ] Decide whether create-time and update-time collection mutation semantics should be normalized more explicitly, especially where some commands are intentionally update-only.
+- [ ] Review whether `relationCoModelFieldName` should be validated more aggressively, because this field is central to child binding and inverse resolution.
+- [ ] Consider whether `relationFieldFixedFilter` should be enforced during relation mutation so child records cannot be linked outside the authored collection scope.
+- [ ] Add targeted coverage for `set`, `clear`, `link`, `unlink`, `create`, `update`, `delete`, invalid command payloads, and partial update behavior.
 
 ## `many-to-many`
 
-- [ ] Review pending.
+- [ ] Clarify and document owner-side versus inverse-side mutation semantics so clients understand which effective field names and id lists are honored during CRUD operations.
+- [ ] Review whether malformed owner-side metadata such as missing `isRelationManyToManyOwner` or mismatched inverse names should fail earlier and more clearly.
+- [ ] Decide whether `relationJoinTableName` and related ownership attrs need stronger validation at metadata authoring time to avoid ambiguous join behavior later.
+- [ ] Review whether `relationFieldFixedFilter` should be enforced during membership mutation so unsupported links cannot be created through direct payloads.
+- [ ] Consider whether create, update, and delete operations against related entities should be more clearly separated from plain membership operations such as `set`, `link`, and `unlink`.
+- [ ] Add targeted coverage for owner-side mutations, inverse-side mutations, `set`, `clear`, `link`, `unlink`, related-entity create/update/delete flows, and partial update behavior.
 
 ## `mediaSingle`
 
-- [ ] Review pending.
+- [ ] Clarify and implement the expected behavior for `defaultValue` when a create payload omits a `mediaSingle` field, including whether the field should ever accept persisted references without a new upload.
+- [ ] Review whether media validation should normalize authored `mediaTypes` values more explicitly so unsupported tokens fail early and predictably.
+- [ ] Consider whether storage-provider resolution should fail with a clearer field-specific error when `mediaStorageProviderUserKey` is missing or invalid.
+- [ ] Review whether replace and delete semantics should be more explicit in the CRUD layer when an existing asset is being updated or removed.
+- [ ] Consider whether upload validation should be refactored into shared utilities so size, type, and required checks stay consistent across media field types.
+- [ ] Add targeted coverage for required create-time uploads, oversized files, unsupported media types, missing providers, replacement flows, and partial update behavior.
 
 ## `mediaMultiple`
 
-- [ ] Review pending.
+- [ ] Align collection-level validation with the single-media path so `mediaTypes` and `mediaMaxSizeKb` are enforced consistently for every uploaded file.
+- [ ] Clarify and implement the expected behavior for `defaultValue` when a create payload omits a `mediaMultiple` field, including whether persisted media references should ever be accepted directly.
+- [ ] Review whether storage-provider resolution should fail with a clearer field-specific error when `mediaStorageProviderUserKey` is missing or invalid.
+- [ ] Decide what the canonical update semantics should be for attachment collections: append-only, replace-all, explicit remove, or a more command-style contract.
+- [ ] Consider whether media collection validation should report per-file errors more explicitly when one file fails and others succeed.
+- [ ] Add targeted coverage for required create-time collections, mixed valid and invalid uploads, oversized files, unsupported media types, missing providers, and partial update behavior.
 
 ## `computed`
 
-- [ ] Review pending.
+- [ ] Clarify and document the supported provider contract more explicitly, including what a computed-field provider must return and how failures should be surfaced to callers.
+- [ ] Review whether `computedFieldValueProviderCtxt` should be validated as JSON earlier and with clearer error messaging before provider execution begins.
+- [ ] Decide whether inline computation should remain skipped on partial updates by default, or whether some computed fields need an opt-in recompute path during patch-style operations.
+- [ ] Review whether `computedFieldTriggerConfig` should be validated more aggressively so unsupported operations or malformed trigger definitions fail earlier.
+- [ ] Consider whether the CRUD layer should verify that the provider’s returned value matches `computedFieldValueType` before persistence.
+- [ ] Add targeted coverage for inline provider execution, malformed provider context, missing providers, trigger-configured fields, partial updates, and mismatched computed value types.