@riddledc/riddle-proof 0.7.90 → 0.7.92

package/dist/{chunk-4FMBHM4E.js → chunk-2SGLFPFX.js}

@@ -3097,6 +3097,10 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function profileCheckAppliesToViewport(check, viewport) {
+  if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
+  return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
+}
 function setupActionType(action) {
   return String(action && action.type ? action.type : "").replace(/-/g, "_");
 }
@@ -3114,6 +3118,30 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+async function waitForAnyVisibleSelector(context, selector, timeout) {
+  const deadline = Date.now() + setupNumber(timeout, 15000);
+  let lastReason = "selector_not_found";
+  while (Date.now() <= deadline) {
+    try {
+      const locator = context.locator(selector);
+      const count = await locator.count();
+      if (!count) {
+        lastReason = "selector_not_found";
+      } else {
+        lastReason = "no_visible_match";
+        for (let index = 0; index < count; index += 1) {
+          if (await locator.nth(index).isVisible().catch(() => false)) {
+            return { ok: true, count, index };
+          }
+        }
+      }
+    } catch (error) {
+      lastReason = String(error && error.message ? error.message : error).slice(0, 500);
+    }
+    await page.waitForTimeout(200);
+  }
+  throw new Error("No visible match for selector " + selector + ": " + lastReason);
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -3447,7 +3475,7 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "wait_for_selector") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
+      await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
     if (type === "drag") {
@@ -4463,7 +4491,7 @@ async function collectRouteInventory(check, viewport) {
       try {
         await page.goto(targetUrl, { waitUntil: "domcontentloaded", timeout: 90000 });
         if (profile.target.wait_for_selector) {
-          await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 }).catch(() => {});
+          await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
         const index = await findInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
@@ -4522,7 +4550,7 @@ async function captureViewport(viewport) {
   }
   if (!navigationError && profile.target.wait_for_selector) {
     try {
-      await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 });
+      await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000);
     } catch (error) {
       waitError = String(error && error.message ? error.message : error).slice(0, 1000);
     }
@@ -4626,6 +4654,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
+    if (!profileCheckAppliesToViewport(check, viewport)) continue;
     if (
       (
         check.type === "selector_visible"
@@ -4661,7 +4690,7 @@ async function captureViewport(viewport) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
   let routeInventory;
-  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
+  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory" && profileCheckAppliesToViewport(check, viewport));
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
   if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
@@ -4766,7 +4795,7 @@ function buildProfileEvidence(currentViewports) {
           })),
         })),
       link_status: currentViewports
-        .filter((viewport) => viewport.link_statuses)
+        .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
         .map((viewport) => ({
           viewport: viewport.name,
           selectors: Object.entries(viewport.link_statuses || {}).map(([selector, statusSet]) => ({

package/dist/{chunk-6RQGBHJ5.js → chunk-OI57LO6Y.js}

@@ -48,12 +48,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -80,6 +81,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -87,6 +89,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = mkdtempSync(path.join(tmpdir(), "riddle-upload-"));
   const tarball = path.join(scratch, `${label}.tar.gz`);
@@ -318,6 +323,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -331,6 +337,7 @@ export {
   RiddleApiError,
   resolveRiddleApiKey,
   riddleRequestJson,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   parseRiddleViewport,
   runRiddleServerPreview,

package/dist/cli.cjs

@@ -6609,12 +6609,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -6641,6 +6642,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -6648,6 +6650,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs5.mkdtempSync)(import_node_path5.default.join((0, import_node_os2.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path5.default.join(scratch, `${label}.tar.gz`);
@@ -6879,6 +6884,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -9968,6 +9974,10 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function profileCheckAppliesToViewport(check, viewport) {
+  if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
+  return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
+}
 function setupActionType(action) {
   return String(action && action.type ? action.type : "").replace(/-/g, "_");
 }
@@ -9985,6 +9995,30 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+async function waitForAnyVisibleSelector(context, selector, timeout) {
+  const deadline = Date.now() + setupNumber(timeout, 15000);
+  let lastReason = "selector_not_found";
+  while (Date.now() <= deadline) {
+    try {
+      const locator = context.locator(selector);
+      const count = await locator.count();
+      if (!count) {
+        lastReason = "selector_not_found";
+      } else {
+        lastReason = "no_visible_match";
+        for (let index = 0; index < count; index += 1) {
+          if (await locator.nth(index).isVisible().catch(() => false)) {
+            return { ok: true, count, index };
+          }
+        }
+      }
+    } catch (error) {
+      lastReason = String(error && error.message ? error.message : error).slice(0, 500);
+    }
+    await page.waitForTimeout(200);
+  }
+  throw new Error("No visible match for selector " + selector + ": " + lastReason);
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -10318,7 +10352,7 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "wait_for_selector") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
+      await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
     if (type === "drag") {
@@ -11334,7 +11368,7 @@ async function collectRouteInventory(check, viewport) {
       try {
         await page.goto(targetUrl, { waitUntil: "domcontentloaded", timeout: 90000 });
         if (profile.target.wait_for_selector) {
-          await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 }).catch(() => {});
+          await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
         const index = await findInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
@@ -11393,7 +11427,7 @@ async function captureViewport(viewport) {
   }
   if (!navigationError && profile.target.wait_for_selector) {
     try {
-      await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 });
+      await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000);
     } catch (error) {
       waitError = String(error && error.message ? error.message : error).slice(0, 1000);
     }
@@ -11497,6 +11531,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
+    if (!profileCheckAppliesToViewport(check, viewport)) continue;
     if (
       (
         check.type === "selector_visible"
@@ -11532,7 +11567,7 @@ async function captureViewport(viewport) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
   let routeInventory;
-  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
+  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory" && profileCheckAppliesToViewport(check, viewport));
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
   if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
@@ -11637,7 +11672,7 @@ function buildProfileEvidence(currentViewports) {
           })),
         })),
       link_status: currentViewports
-        .filter((viewport) => viewport.link_statuses)
+        .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
         .map((viewport) => ({
           viewport: viewport.name,
           selectors: Object.entries(viewport.link_statuses || {}).map(([selector, statusSet]) => ({
@@ -11792,7 +11827,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
     "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
-    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
+    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
     "  riddle-proof-loop riddle-poll <job-id> [--wait] [--attempts n] [--quiet]",
@@ -11856,6 +11891,11 @@ function optionNumber(options, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function previewFrameworkOption(options) {
+  const framework = optionString(options, "framework") ?? "static";
+  if (framework === "spa" || framework === "static") return framework;
+  throw new Error("--framework must be spa or static.");
+}
 function readStdin() {
   return (0, import_node_fs6.readFileSync)(0, "utf-8");
 }
@@ -12568,7 +12608,7 @@ async function main() {
   if (command === "riddle-preview-deploy") {
     const buildDir = positional[1];
     const label = positional[2];
-    const result = await createRiddleApiClient(riddleClientConfig(options)).deployStaticPreview(buildDir, label);
+    const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/cli.js

@@ -10,11 +10,11 @@ import {
   profileStatusExitCode,
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
-} from "./chunk-4FMBHM4E.js";
+} from "./chunk-2SGLFPFX.js";
 import {
   createRiddleApiClient,
   parseRiddleViewport
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -45,7 +45,7 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
     "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--strict true|false] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--quiet]",
-    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label>",
+    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
     "  riddle-proof-loop riddle-poll <job-id> [--wait] [--attempts n] [--quiet]",
@@ -109,6 +109,11 @@ function optionNumber(options, ...keys) {
 function profileOutputDirOption(options) {
   return optionString(options, "output") ?? optionString(options, "outputDir");
 }
+function previewFrameworkOption(options) {
+  const framework = optionString(options, "framework") ?? "static";
+  if (framework === "spa" || framework === "static") return framework;
+  throw new Error("--framework must be spa or static.");
+}
 function readStdin() {
   return readFileSync(0, "utf-8");
 }
@@ -821,7 +826,7 @@ async function main() {
   if (command === "riddle-preview-deploy") {
     const buildDir = positional[1];
     const label = positional[2];
-    const result = await createRiddleApiClient(riddleClientConfig(options)).deployStaticPreview(buildDir, label);
+    const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/index.cjs

@@ -2968,6 +2968,7 @@ __export(index_exports, {
   createRunResult: () => createRunResult,
   createRunState: () => createRunState,
   createRunStatusSnapshot: () => createRunStatusSnapshot,
+  deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
   extractBasicGameplayEvidence: () => extractBasicGameplayEvidence,
   extractPlayabilityEvidence: () => extractPlayabilityEvidence,
@@ -11825,6 +11826,10 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function profileCheckAppliesToViewport(check, viewport) {
+  if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
+  return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
+}
 function setupActionType(action) {
   return String(action && action.type ? action.type : "").replace(/-/g, "_");
 }
@@ -11842,6 +11847,30 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+async function waitForAnyVisibleSelector(context, selector, timeout) {
+  const deadline = Date.now() + setupNumber(timeout, 15000);
+  let lastReason = "selector_not_found";
+  while (Date.now() <= deadline) {
+    try {
+      const locator = context.locator(selector);
+      const count = await locator.count();
+      if (!count) {
+        lastReason = "selector_not_found";
+      } else {
+        lastReason = "no_visible_match";
+        for (let index = 0; index < count; index += 1) {
+          if (await locator.nth(index).isVisible().catch(() => false)) {
+            return { ok: true, count, index };
+          }
+        }
+      }
+    } catch (error) {
+      lastReason = String(error && error.message ? error.message : error).slice(0, 500);
+    }
+    await page.waitForTimeout(200);
+  }
+  throw new Error("No visible match for selector " + selector + ": " + lastReason);
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -12175,7 +12204,7 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "wait_for_selector") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
+      await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
     if (type === "drag") {
@@ -13191,7 +13220,7 @@ async function collectRouteInventory(check, viewport) {
       try {
         await page.goto(targetUrl, { waitUntil: "domcontentloaded", timeout: 90000 });
         if (profile.target.wait_for_selector) {
-          await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 }).catch(() => {});
+          await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
         const index = await findInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
@@ -13250,7 +13279,7 @@ async function captureViewport(viewport) {
   }
   if (!navigationError && profile.target.wait_for_selector) {
     try {
-      await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 });
+      await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000);
     } catch (error) {
       waitError = String(error && error.message ? error.message : error).slice(0, 1000);
     }
@@ -13354,6 +13383,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
+    if (!profileCheckAppliesToViewport(check, viewport)) continue;
     if (
       (
         check.type === "selector_visible"
@@ -13389,7 +13419,7 @@ async function captureViewport(viewport) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
   let routeInventory;
-  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
+  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory" && profileCheckAppliesToViewport(check, viewport));
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
   if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
@@ -13494,7 +13524,7 @@ function buildProfileEvidence(currentViewports) {
           })),
         })),
       link_status: currentViewports
-        .filter((viewport) => viewport.link_statuses)
+        .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
         .map((viewport) => ({
           viewport: viewport.name,
           selectors: Object.entries(viewport.link_statuses || {}).map(([selector, statusSet]) => ({
@@ -13689,12 +13719,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -13721,6 +13752,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -13728,6 +13760,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs5.mkdtempSync)(import_node_path5.default.join((0, import_node_os2.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path5.default.join(scratch, `${label}.tar.gz`);
@@ -13959,6 +13994,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -14036,6 +14072,7 @@ function createRiddleApiClient(config = {}) {
   createRunResult,
   createRunState,
   createRunStatusSnapshot,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   extractBasicGameplayEvidence,
   extractPlayabilityEvidence,

package/dist/index.d.cts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, extractRiddleProofProfileResult, normalizeRiddleProofProfile, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

@@ -58,12 +58,13 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-4FMBHM4E.js";
+} from "./chunk-2SGLFPFX.js";
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,
@@ -72,7 +73,7 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
@@ -207,6 +208,7 @@ export {
   createRunResult,
   createRunState,
   createRunStatusSnapshot,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   extractBasicGameplayEvidence,
   extractPlayabilityEvidence,

package/dist/profile.cjs

@@ -3140,6 +3140,10 @@ function textMatches(sample, check) {
   }
   return String(sample || "").includes(check.text || "");
 }
+function profileCheckAppliesToViewport(check, viewport) {
+  if (!Array.isArray(check.viewports) || !check.viewports.length) return true;
+  return Boolean(viewport && viewport.name && check.viewports.includes(viewport.name));
+}
 function setupActionType(action) {
   return String(action && action.type ? action.type : "").replace(/-/g, "_");
 }
@@ -3157,6 +3161,30 @@ function setupTextMatches(sample, action) {
   }
   return String(sample || "").includes(action.text || "");
 }
+async function waitForAnyVisibleSelector(context, selector, timeout) {
+  const deadline = Date.now() + setupNumber(timeout, 15000);
+  let lastReason = "selector_not_found";
+  while (Date.now() <= deadline) {
+    try {
+      const locator = context.locator(selector);
+      const count = await locator.count();
+      if (!count) {
+        lastReason = "selector_not_found";
+      } else {
+        lastReason = "no_visible_match";
+        for (let index = 0; index < count; index += 1) {
+          if (await locator.nth(index).isVisible().catch(() => false)) {
+            return { ok: true, count, index };
+          }
+        }
+      }
+    } catch (error) {
+      lastReason = String(error && error.message ? error.message : error).slice(0, 500);
+    }
+    await page.waitForTimeout(200);
+  }
+  throw new Error("No visible match for selector " + selector + ": " + lastReason);
+}
 function setupHasOwn(action, key) {
   return Boolean(action) && Object.keys(action).includes(key);
 }
@@ -3490,7 +3518,7 @@ async function executeSetupAction(action, ordinal, viewport) {
     if (type === "wait_for_selector") {
       const scope = await setupActionScope(action, timeout);
       if (!scope.ok) return setupScopeFailure(base, scope);
-      await scope.context.waitForSelector(action.selector, { state: "visible", timeout });
+      await waitForAnyVisibleSelector(scope.context, action.selector, timeout);
       return { ...base, ...setupScopeEvidence(scope), ok: true, timeout_ms: timeout };
     }
     if (type === "drag") {
@@ -4506,7 +4534,7 @@ async function collectRouteInventory(check, viewport) {
       try {
         await page.goto(targetUrl, { waitUntil: "domcontentloaded", timeout: 90000 });
         if (profile.target.wait_for_selector) {
-          await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 }).catch(() => {});
+          await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000).catch(() => {});
         }
         const index = await findInventoryLinkIndex(check, expectedRoute.path);
         if (index < 0) {
@@ -4565,7 +4593,7 @@ async function captureViewport(viewport) {
   }
   if (!navigationError && profile.target.wait_for_selector) {
     try {
-      await page.waitForSelector(profile.target.wait_for_selector, { state: "visible", timeout: 15000 });
+      await waitForAnyVisibleSelector(page, profile.target.wait_for_selector, 15000);
     } catch (error) {
       waitError = String(error && error.message ? error.message : error).slice(0, 1000);
     }
@@ -4669,6 +4697,7 @@ async function captureViewport(viewport) {
   const text_matches = {};
   const link_statuses = {};
   for (const check of profile.checks || []) {
+    if (!profileCheckAppliesToViewport(check, viewport)) continue;
     if (
       (
         check.type === "selector_visible"
@@ -4704,7 +4733,7 @@ async function captureViewport(viewport) {
     pageErrors.push({ message: "saveScreenshot failed: " + String(error && error.message ? error.message : error).slice(0, 500) });
   }
   let routeInventory;
-  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory");
+  const routeInventoryCheck = (profile.checks || []).find((check) => check.type === "route_inventory" && profileCheckAppliesToViewport(check, viewport));
   const firstViewportName = (profile.target.viewports || [])[0] && (profile.target.viewports || [])[0].name;
   if (routeInventoryCheck && (routeInventoryCheck.run_all_viewports || !firstViewportName || viewport.name === firstViewportName)) {
     try {
@@ -4809,7 +4838,7 @@ function buildProfileEvidence(currentViewports) {
           })),
         })),
       link_status: currentViewports
-        .filter((viewport) => viewport.link_statuses)
+        .filter((viewport) => viewport.link_statuses && Object.keys(viewport.link_statuses).length)
         .map((viewport) => ({
           viewport: viewport.name,
           selectors: Object.entries(viewport.link_statuses || {}).map(([selector, statusSet]) => ({

package/dist/profile.js

@@ -19,7 +19,7 @@ import {
   resolveRiddleProofProfileTimeoutSec,
   slugifyRiddleProofProfileName,
   summarizeRiddleProofProfileResult
-} from "./chunk-4FMBHM4E.js";
+} from "./chunk-2SGLFPFX.js";
 export {
   RIDDLE_PROOF_PROFILE_CHECK_TYPES,
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,

package/dist/riddle-client.cjs

@@ -34,6 +34,7 @@ __export(riddle_client_exports, {
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError: () => RiddleApiError,
   createRiddleApiClient: () => createRiddleApiClient,
+  deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
   isTerminalRiddleJobStatus: () => isTerminalRiddleJobStatus,
   parseRiddleViewport: () => parseRiddleViewport,
@@ -93,12 +94,13 @@ async function riddleRequestJson(config, pathname, init = {}) {
   if (!response.ok) throw new RiddleApiError(pathname, response.status, text);
   return json ?? text;
 }
-async function deployRiddleStaticPreview(config, directory, label) {
+async function deployRiddlePreview(config, directory, label, framework = "static") {
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
+  if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
-    body: JSON.stringify({ framework: "static", label })
+    body: JSON.stringify({ framework, label })
   });
   const id = String(created.id || "");
   const uploadUrl = String(created.upload_url || "");
@@ -125,6 +127,7 @@ async function deployRiddleStaticPreview(config, directory, label) {
     ok: true,
     id: String(published.id || id),
     label,
+    framework,
     preview_url: String(published.preview_url || ""),
     file_count: typeof published.file_count === "number" ? published.file_count : void 0,
     total_bytes: typeof published.total_bytes === "number" ? published.total_bytes : void 0,
@@ -132,6 +135,9 @@ async function deployRiddleStaticPreview(config, directory, label) {
     raw: published
   };
 }
+async function deployRiddleStaticPreview(config, directory, label) {
+  return deployRiddlePreview(config, directory, label, "static");
+}
 function createTarball(directory, label, exclude = []) {
   const scratch = (0, import_node_fs.mkdtempSync)(import_node_path.default.join((0, import_node_os.tmpdir)(), "riddle-upload-"));
   const tarball = import_node_path.default.join(scratch, `${label}.tar.gz`);
@@ -363,6 +369,7 @@ async function pollRiddleJob(config, jobId, options = {}) {
 function createRiddleApiClient(config = {}) {
   return {
     requestJson: (pathname, init) => riddleRequestJson(config, pathname, init),
+    deployPreview: (directory, label, framework = "static") => deployRiddlePreview(config, directory, label, framework),
     deployStaticPreview: (directory, label) => deployRiddleStaticPreview(config, directory, label),
     runScript: (input) => runRiddleScript(config, input),
     runServerPreview: (input) => runRiddleServerPreview(config, input),
@@ -375,6 +382,7 @@ function createRiddleApiClient(config = {}) {
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,

package/dist/riddle-client.d.cts

@@ -32,10 +32,12 @@ interface RiddlePollJobOptions {
     progressEveryMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
+type RiddlePreviewFramework = "spa" | "static";
 interface RiddlePreviewDeployResult {
     ok: true;
     id: string;
     label: string;
+    framework: RiddlePreviewFramework;
     preview_url: string;
     file_count?: number;
     total_bytes?: number;
@@ -101,6 +103,7 @@ declare class RiddleApiError extends Error {
 }
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -112,10 +115,11 @@ declare function isTerminalRiddleJobStatus(status: unknown): boolean;
 declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: RiddlePollJobOptions): Promise<RiddlePollJobResult>;
 declare function createRiddleApiClient(config?: RiddleClientConfig): {
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
     deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.d.ts

@@ -32,10 +32,12 @@ interface RiddlePollJobOptions {
     progressEveryMs?: number;
     onProgress?: (snapshot: RiddlePollProgressSnapshot) => void | Promise<void>;
 }
+type RiddlePreviewFramework = "spa" | "static";
 interface RiddlePreviewDeployResult {
     ok: true;
     id: string;
     label: string;
+    framework: RiddlePreviewFramework;
     preview_url: string;
     file_count?: number;
     total_bytes?: number;
@@ -101,6 +103,7 @@ declare class RiddleApiError extends Error {
 }
 declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
+declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -112,10 +115,11 @@ declare function isTerminalRiddleJobStatus(status: unknown): boolean;
 declare function pollRiddleJob(config: RiddleClientConfig, jobId: string, options?: RiddlePollJobOptions): Promise<RiddlePollJobResult>;
 declare function createRiddleApiClient(config?: RiddleClientConfig): {
     requestJson: <T = unknown>(pathname: string, init?: RequestInit) => Promise<T>;
+    deployPreview: (directory: string, label: string, framework?: RiddlePreviewFramework) => Promise<RiddlePreviewDeployResult>;
     deployStaticPreview: (directory: string, label: string) => Promise<RiddlePreviewDeployResult>;
     runScript: (input: RiddleRunScriptInput) => Promise<Record<string, unknown>>;
     runServerPreview: (input: RiddleServerPreviewInput) => Promise<RiddleServerPreviewResult>;
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.js

@@ -3,6 +3,7 @@ import {
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,
@@ -11,12 +12,13 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-6RQGBHJ5.js";
+} from "./chunk-OI57LO6Y.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
   createRiddleApiClient,
+  deployRiddlePreview,
   deployRiddleStaticPreview,
   isTerminalRiddleJobStatus,
   parseRiddleViewport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.90",
+  "version": "0.7.92",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",