document360-capture 0.2.8 → 0.2.10

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import{Command as Ue}from"commander";import{createRequire as Ne}from"node:module";import{input as Xt,confirm as Yt}from"@inquirer/prompts";import{existsSync as K,readFileSync as Kt}from"node:fs";import{basename as Vt,join as Qt}from"node:path";import{readFileSync as J,writeFileSync as Lt,existsSync as W,mkdirSync as Mt}from"node:fs";import{basename as Bt,dirname as _t,join as U}from"node:path";var Ft=U(".d360-writer","capture.json"),j={captureDir:".d360-writer/user-docs/_capture",outputDir:".d360-writer/user-docs/_screenshots",viewport:{width:1440,height:900},loginTimeoutMs:0,annotation:{enabled:!0}},b=class extends Error{};function d(t=process.cwd()){return U(t,Ft)}function m(t){if(!W(t))throw new Error(`No project config at ${t}. Run \`d360-capture init\` to create one.`);let e=JSON.parse(J(t,"utf8").replace(/^/,""));return Jt(e,t)}function O(t,e){Mt(_t(t),{recursive:!0}),Lt(t,JSON.stringify(e,null,2)+`
-`,"utf8")}function Ht(t){try{return"^"+new URL(t).origin.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}catch{return"."}}function Jt(t,e,o=process.cwd()){Wt(t,e);let r=Object.keys(t.profiles),n=t.defaultProfile??(r.length===1?r[0]:r.includes("staging")?"staging":r[0]);return{projectId:t.projectId||qt(o)||Bt(o),captureDir:t.captureDir??j.captureDir,outputDir:t.outputDir??j.outputDir,viewport:t.viewport??{...j.viewport},loginTimeoutMs:t.loginTimeoutMs??j.loginTimeoutMs,annotation:t.annotation??{...j.annotation},profiles:t.profiles,defaultProfile:n}}function $(t,e){let o=e??t.defaultProfile,r=t.profiles[o];if(!r){let i=Object.keys(t.profiles).join(", ");throw new b(`Unknown profile "${o}". Available: ${i}`)}let n=r.connection.authBoundaryUrlPattern;return{name:o,connection:{startUrl:r.connection.startUrl,authBoundaryUrlPattern:n||Ht(r.connection.startUrl)},captureDir:r.captureDir??t.captureDir,outputDir:r.outputDir??t.outputDir,viewport:r.viewport??t.viewport,production:r.production===!0,scope:r.scope??{},authBoundaryDefaulted:!n}}function Wt(t,e){if(t.environments&&!t.profiles)throw new b(`Config at ${e} uses the old "environments" shape, which is no longer supported. It is now "profiles" (each with a "connection" { startUrl }) + "defaultProfile". Re-run \`d360-capture init\`, then \`d360-capture auth --profile <name>\`.`);if(!t.profiles||Object.keys(t.profiles).length===0)throw new b(`Invalid config at ${e}: needs at least one profile under "profiles".`);for(let[o,r]of Object.entries(t.profiles))if(!r?.connection?.startUrl)throw new b(`Invalid config at ${e}: profile "${o}" is missing connection.startUrl.`);if(t.defaultProfile&&!t.profiles[t.defaultProfile])throw new b(`Invalid config at ${e}: defaultProfile "${t.defaultProfile}" is not in profiles.`)}function qt(t){let e=U(t,"package.json");if(!W(e))return null;try{return JSON.parse(J(e,"utf8")).name??null}catch{return null}}import{existsSync as q,readFileSync as Gt}from"node:fs";import{join as G}from"node:path";var zt=G(".d360-writer","config.json");function z(t=process.cwd()){return G(t,zt)}function X(t=process.cwd()){return q(z(t))}function Y(t=process.cwd()){let e=z(t);if(!q(e))return{};try{let o=JSON.parse(Gt(e,"utf8").replace(/^/,"")),r=o.docsDir?.replace(/\/+$/,"");return{projectId:o.projectId,captureDir:o.captureDir??(r?`${r}/_capture`:void 0),outputDir:o.outputDir??(r?`${r}/_screenshots`:void 0)}}catch{return{}}}async function V(t={}){let e=process.cwd(),o=d(e),r=t.yes===!0;if(K(o)&&!r&&!await Yt({message:`${o} already exists. Overwrite?`,default:!1})){console.log("Init cancelled.");return}let n=Y(e),i=n.projectId||Zt(e)||Vt(e),s=[n.projectId&&"project name",n.captureDir&&"directories"].filter(Boolean);s.length>0?(console.log(""),console.log(`Found .d360-writer/config.json \u2014 inheriting ${s.join(" + ")}.`)):X(e)&&(console.log(""),console.log("Found .d360-writer/config.json (could not read defaults from it \u2014 using built-in defaults)."));let a=r?"https://example.com/":await Xt({message:"Live app URL (where captures start):",default:"https://example.com/",validate:p=>p.startsWith("http")?!0:"Must be a full URL"}),l={projectId:i,...n.captureDir?{captureDir:n.captureDir}:{},...n.outputDir?{outputDir:n.outputDir}:{},profiles:{staging:{connection:{startUrl:a}}},defaultProfile:"staging"};O(o,l),console.log(""),console.log(`\u2713 Wrote ${o}`),r&&a==="https://example.com/"&&console.log("  \u26A0 Set the staging profile's connection.startUrl to your real app URL."),console.log(""),console.log("Next steps:"),console.log("  1. d360-capture auth        # log in once, no timeout"),console.log("  2. d360-capture capture     # run all specs in the capture dir"),console.log(""),console.log("Add a prod profile or tune the auth boundary later by editing .d360-writer/capture.json."),console.log("")}function Zt(t){let e=Qt(t,"package.json");if(!K(e))return null;try{return JSON.parse(Kt(e,"utf8")).name??null}catch{return null}}import{chromium as re}from"playwright";import{existsSync as Q,mkdirSync as te,statSync as ee}from"node:fs";import{homedir as oe}from"node:os";import{join as N,dirname as Ze}from"node:path";function Z(){return N(oe(),".document360-capture","auth-states")}function R(t,e){return N(Z(),t,`${e}.json`)}function tt(t){let e=N(Z(),t);Q(e)||te(e,{recursive:!0})}function x(t,e){let o=R(t,e);if(!Q(o))return{path:o,exists:!1};let r=ee(o);return{path:o,exists:!0,ageMs:Date.now()-r.mtimeMs}}async function et(t){let e=m(d()),o=$(e,t.profile);tt(e.projectId);let r=R(e.projectId,o.name);console.log(""),o.production&&console.log(`\u26A0 Profile "${o.name}" is PRODUCTION.`),console.log(`Opening Chromium against ${o.connection.startUrl}`),console.log(`Auth-state will save to: ${r}`),console.log("");let n=await re.launch({headless:!1,args:["--start-maximized"]}),i=await n.newContext({viewport:null}),s=await i.newPage();await s.goto(o.connection.startUrl,{waitUntil:"domcontentloaded"}),console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),console.log("  Log in fully (MFA included) at your own pace."),console.log("  When you reach the post-login app, come back to this"),console.log("  terminal and press ENTER to save the session."),console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),console.log("");let a=new RegExp(o.connection.authBoundaryUrlPattern),l=setInterval(()=>{a.test(s.url())&&i.storageState({path:r}).catch(()=>{})},3e4);try{for(;;){await ne();let p=s.url();if(a.test(p))break;console.log(""),console.log("\u2717 Login doesn't look complete yet \u2014 the browser is still at:"),console.log(`    ${p}`),console.log("  Finish logging in until you can see the app, then press ENTER again."),console.log("  (Ctrl+C aborts without saving.)")}await i.storageState({path:r}),console.log(""),console.log(`\u2713 Session saved to ${r}`),console.log("  This file contains session cookies \u2014 never commit it to git.")}finally{clearInterval(l),await n.close().catch(()=>{})}}function ne(){return new Promise(t=>{let e=()=>{process.stdin.off("data",e),process.stdin.pause(),t()};process.stdin.resume(),process.stdin.once("data",e)})}import{existsSync as be,readdirSync as De}from"node:fs";import{isAbsolute as $t,resolve as xt}from"node:path";import{writeFileSync as ot,mkdirSync as ie,existsSync as rt}from"node:fs";import{createRequire as se}from"node:module";import{join as k,isAbsolute as nt,resolve as it}from"node:path";var T=se(import.meta.url);function st(t){let{cwd:e,profileName:o,captureDir:r,viewport:n,storageStatePath:i}=t,s=k(e,".d360-writer","cache");rt(s)||ie(s,{recursive:!0});let a=k(s,`playwright.${o}.config.cjs`),l=nt(r)?r:it(e,r),p=nt(i)?i:it(e,i),f=T.resolve("@playwright/test"),c=`// Generated by document360-capture \u2014 do not edit by hand.
+import{Command as Ke}from"commander";import{createRequire as Xe}from"node:module";import{input as Vt,confirm as Zt}from"@inquirer/prompts";import{existsSync as Q,readFileSync as te}from"node:fs";import{basename as ee,join as oe}from"node:path";import{readFileSync as W,writeFileSync as Ft,existsSync as q,mkdirSync as Jt}from"node:fs";import{basename as Ht,dirname as Wt,join as U}from"node:path";var qt=U(".d360-writer","capture.json"),j={captureDir:".d360-writer/user-docs/_capture",outputDir:".d360-writer/user-docs/_screenshots",viewport:{width:1440,height:900},loginTimeoutMs:0,annotation:{enabled:!0}},b=class extends Error{};function d(t=process.cwd()){return U(t,qt)}function m(t){if(!q(t))throw new Error(`No project config at ${t}. Run \`d360-capture init\` to create one.`);let e=JSON.parse(W(t,"utf8").replace(/^/,""));return zt(e,t)}function O(t,e){Jt(Wt(t),{recursive:!0}),Ft(t,JSON.stringify(e,null,2)+`
+`,"utf8")}function Gt(t){try{return"^"+new URL(t).origin.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}catch{return"."}}function zt(t,e,o=process.cwd()){Kt(t,e);let r=Object.keys(t.profiles),n=t.defaultProfile??(r.length===1?r[0]:r.includes("staging")?"staging":r[0]);return{projectId:t.projectId||Xt(o)||Ht(o),captureDir:t.captureDir??j.captureDir,outputDir:t.outputDir??j.outputDir,viewport:t.viewport??{...j.viewport},loginTimeoutMs:t.loginTimeoutMs??j.loginTimeoutMs,annotation:t.annotation??{...j.annotation},profiles:t.profiles,defaultProfile:n}}function $(t,e){let o=e??t.defaultProfile,r=t.profiles[o];if(!r){let i=Object.keys(t.profiles).join(", ");throw new b(`Unknown profile "${o}". Available: ${i}`)}let n=r.connection.authBoundaryUrlPattern;return{name:o,connection:{startUrl:r.connection.startUrl,authBoundaryUrlPattern:n||Gt(r.connection.startUrl)},captureDir:r.captureDir??t.captureDir,outputDir:r.outputDir??t.outputDir,viewport:r.viewport??t.viewport,production:r.production===!0,scope:r.scope??{},authBoundaryDefaulted:!n}}function Kt(t,e){if(t.environments&&!t.profiles)throw new b(`Config at ${e} uses the old "environments" shape, which is no longer supported. It is now "profiles" (each with a "connection" { startUrl }) + "defaultProfile". Re-run \`d360-capture init\`, then \`d360-capture auth --profile <name>\`.`);if(!t.profiles||Object.keys(t.profiles).length===0)throw new b(`Invalid config at ${e}: needs at least one profile under "profiles".`);for(let[o,r]of Object.entries(t.profiles))if(!r?.connection?.startUrl)throw new b(`Invalid config at ${e}: profile "${o}" is missing connection.startUrl.`);if(t.defaultProfile&&!t.profiles[t.defaultProfile])throw new b(`Invalid config at ${e}: defaultProfile "${t.defaultProfile}" is not in profiles.`)}function Xt(t){let e=U(t,"package.json");if(!q(e))return null;try{return JSON.parse(W(e,"utf8")).name??null}catch{return null}}import{existsSync as G,readFileSync as Yt}from"node:fs";import{join as z}from"node:path";var Qt=z(".d360-writer","config.json");function K(t=process.cwd()){return z(t,Qt)}function X(t=process.cwd()){return G(K(t))}function Y(t=process.cwd()){let e=K(t);if(!G(e))return{};try{let o=JSON.parse(Yt(e,"utf8").replace(/^/,"")),r=o.docsDir?.replace(/\/+$/,"");return{projectId:o.projectId,captureDir:o.captureDir??(r?`${r}/_capture`:void 0),outputDir:o.outputDir??(r?`${r}/_screenshots`:void 0)}}catch{return{}}}async function V(t={}){let e=process.cwd(),o=d(e),r=t.yes===!0;if(Q(o)&&!r&&!await Zt({message:`${o} already exists. Overwrite?`,default:!1})){console.log("Init cancelled.");return}let n=Y(e),i=n.projectId||re(e)||ee(e),s=[n.projectId&&"project name",n.captureDir&&"directories"].filter(Boolean);s.length>0?(console.log(""),console.log(`Found .d360-writer/config.json \u2014 inheriting ${s.join(" + ")}.`)):X(e)&&(console.log(""),console.log("Found .d360-writer/config.json (could not read defaults from it \u2014 using built-in defaults)."));let a=r?"https://example.com/":await Vt({message:"Live app URL (where captures start):",default:"https://example.com/",validate:p=>p.startsWith("http")?!0:"Must be a full URL"}),l={projectId:i,...n.captureDir?{captureDir:n.captureDir}:{},...n.outputDir?{outputDir:n.outputDir}:{},profiles:{staging:{connection:{startUrl:a}}},defaultProfile:"staging"};O(o,l),console.log(""),console.log(`\u2713 Wrote ${o}`),r&&a==="https://example.com/"&&console.log("  \u26A0 Set the staging profile's connection.startUrl to your real app URL."),console.log(""),console.log("Next steps:"),console.log("  1. d360-capture auth        # log in once, no timeout"),console.log("  2. d360-capture capture     # run all specs in the capture dir"),console.log(""),console.log("Add a prod profile or tune the auth boundary later by editing .d360-writer/capture.json."),console.log("")}function re(t){let e=oe(t,"package.json");if(!Q(e))return null;try{return JSON.parse(te(e,"utf8")).name??null}catch{return null}}import{chromium as ae}from"playwright";import{existsSync as Z,mkdirSync as ne,statSync as ie}from"node:fs";import{homedir as se}from"node:os";import{join as N,dirname as go}from"node:path";function tt(){return N(se(),".document360-capture","auth-states")}function R(t,e){return N(tt(),t,`${e}.json`)}function et(t){let e=N(tt(),t);Z(e)||ne(e,{recursive:!0})}function x(t,e){let o=R(t,e);if(!Z(o))return{path:o,exists:!1};let r=ie(o);return{path:o,exists:!0,ageMs:Date.now()-r.mtimeMs}}async function ot(t){let e=m(d()),o=$(e,t.profile);et(e.projectId);let r=R(e.projectId,o.name);console.log(""),o.production&&console.log(`\u26A0 Profile "${o.name}" is PRODUCTION.`),console.log(`Opening Chromium against ${o.connection.startUrl}`),console.log(`Auth-state will save to: ${r}`),console.log("");let n=await ae.launch({headless:!1,args:["--start-maximized"]}),i=await n.newContext({viewport:null}),s=await i.newPage();await s.goto(o.connection.startUrl,{waitUntil:"domcontentloaded"}),console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),console.log("  Log in fully (MFA included) at your own pace."),console.log("  When you reach the post-login app, come back to this"),console.log("  terminal and press ENTER to save the session."),console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),console.log("");let a=new RegExp(o.connection.authBoundaryUrlPattern),l=setInterval(()=>{a.test(s.url())&&i.storageState({path:r}).catch(()=>{})},3e4);try{for(;;){await ce();let p=s.url();if(a.test(p))break;console.log(""),console.log("\u2717 Login doesn't look complete yet \u2014 the browser is still at:"),console.log(`    ${p}`),console.log("  Finish logging in until you can see the app, then press ENTER again."),console.log("  (Ctrl+C aborts without saving.)")}await i.storageState({path:r}),console.log(""),console.log(`\u2713 Session saved to ${r}`),console.log("  This file contains session cookies \u2014 never commit it to git.")}finally{clearInterval(l),await n.close().catch(()=>{})}}function ce(){return new Promise(t=>{let e=()=>{process.stdin.off("data",e),process.stdin.pause(),t()};process.stdin.resume(),process.stdin.once("data",e)})}import{existsSync as je,readdirSync as Re}from"node:fs";import{isAbsolute as xt,resolve as bt}from"node:path";import{writeFileSync as rt,mkdirSync as le,existsSync as nt}from"node:fs";import{createRequire as pe}from"node:module";import{join as k,isAbsolute as it,resolve as st}from"node:path";var T=pe(import.meta.url);function at(t){let{cwd:e,profileName:o,captureDir:r,viewport:n,storageStatePath:i}=t,s=k(e,".d360-writer","cache");nt(s)||le(s,{recursive:!0});let a=k(s,`playwright.${o}.config.cjs`),l=it(r)?r:st(e,r),p=it(i)?i:st(e,i),f=T.resolve("@playwright/test"),c=`// Generated by document360-capture \u2014 do not edit by hand.
 const { defineConfig } = require(${JSON.stringify(f)});
 module.exports = defineConfig({
   testDir: ${JSON.stringify(l)},
@@ -18,8 +18,11 @@ module.exports = defineConfig({
     contextOptions: { reducedMotion: 'reduce' },
   },
 });
-`;ot(a,c,"utf8");let u=k(s,`tsconfig.${o}.json`),P=A=>A.replace(/\\/g,"/"),w=T.resolve("document360-capture/helpers"),y=k(T.resolve("@playwright/test/package.json"),".."),h=k(y,"index.mjs"),D=rt(h)?h:f,S={compilerOptions:{baseUrl:".",paths:{"document360-capture/helpers":[P(w)],"@playwright/test":[P(D)]}}};return ot(u,JSON.stringify(S,null,2),"utf8"),{configPath:a,tsconfigPath:u}}import{spawn as ae}from"node:child_process";import{existsSync as ce}from"node:fs";import{createRequire as le}from"node:module";import{fileURLToPath as pe}from"node:url";import{delimiter as ue,dirname as E,join as at}from"node:path";function fe(t,e){return t!==0?"failed":/\b\d+\s+skipped\b/.test(e)&&!/\b\d+\s+passed\b/.test(e)?"skipped":"passed"}var ge=le(import.meta.url);async function ct(t){let{cwd:e,configPath:o,tsconfigPath:r,startUrl:n,authBoundaryUrlPattern:i,specId:s,captureDirAbs:a}=t,l=he();if(!l)return{exitCode:127,stdout:"",stderr:"Cannot locate @playwright/test CLI. Try: npm install -g document360-capture (reinstall)",outcome:"failed"};let p=[l,"test","--config",o,"--tsconfig",r];return s&&p.push(de(`${s}.spec.ts`)),new Promise(f=>{let c="",u="",P=ae(process.execPath,p,{cwd:e,env:{...process.env,CAPTURE_START_URL:n,CAPTURE_AUTH_BOUNDARY:i,CAPTURE_SCOPE:JSON.stringify(t.scope??{}),NODE_PATH:me()},shell:!1}),w=()=>{try{P.kill()}catch{}};t.signal&&(t.signal.aborted?w():t.signal.addEventListener("abort",w,{once:!0})),P.stdout.on("data",y=>{let h=y.toString();c+=h,process.stdout.write(h)}),P.stderr.on("data",y=>{let h=y.toString();u+=h,process.stderr.write(h)}),P.on("error",y=>{t.signal?.removeEventListener("abort",w),u+=`
-[spawn error] ${y.message}`,f({exitCode:127,stdout:c,stderr:u,outcome:"failed"})}),P.on("close",y=>{t.signal?.removeEventListener("abort",w);let h=y??1;f({exitCode:h,stdout:c,stderr:u,outcome:fe(h,c)})})})}function de(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function me(){let t=E(pe(import.meta.url));for(let o=0;o<4&&!ce(at(t,"package.json"));o++)t=E(t);let e=[at(t,"node_modules"),E(t)];return process.env.NODE_PATH&&e.push(process.env.NODE_PATH),e.join(ue)}function he(){let t=["@playwright/test/cli","@playwright/test/cli.js","playwright/cli","playwright/cli.js"];for(let e of t)try{return ge.resolve(e)}catch{}return null}var we=[/login\.microsoftonline\.com/i,/login\.live\.com/i,/accounts\.google\.com/i,/\/oauth(2)?\/authorize/i,/\/sign[- ]?in/i,/\bauthn\b/i],ye=[/waitForURL.*timed?[- ]?out/i,/page\.goto.*redirected/i,/storageState.*invalid/i];function lt(t){return we.some(e=>e.test(t))?!0:ye.some(e=>e.test(t))}import{readdirSync as wt,readFileSync as ve,existsSync as yt,copyFileSync as $e}from"node:fs";import{join as Pt}from"node:path";import B from"sharp";function L(t){return t.replace(/[<>&"']/g,e=>({"<":"&lt;",">":"&gt;","&":"&amp;",'"':"&quot;","'":"&apos;"})[e])}function ut(t){let o=Math.max(0,t.x-4),r=Math.max(0,t.y-4),n=t.width+8,i=t.height+8;return`<rect x="${o}" y="${r}" width="${n}" height="${i}" rx="6" ry="6" fill="rgba(255,213,0,0.18)" stroke="#f5a623" stroke-width="2.5"/>`}function ft(t){return`<rect x="${t.x}" y="${t.y}" width="${t.width}" height="${t.height}" fill="#1f2328"/>`}var M="-apple-system,Segoe UI,sans-serif",pt=(t,e,o)=>Math.max(e,Math.min(o,t)),Pe=13;function gt(t,e,o,r){let n=Pe,i=pt(e.x,n,Math.max(n,o-n)),s=pt(e.y,n,Math.max(n,r-n));return`<circle cx="${i}" cy="${s}" r="${n}" fill="#d1242f" stroke="#fff" stroke-width="2"/><text x="${i}" y="${s+4}" font-family="${M}" font-size="13" font-weight="700" fill="#fff" text-anchor="middle">${L(t)}</text>`}function dt(t,e){return t===0?0:e.pad*2+t*e.lineHeight}function mt(t,e){let{top:o,width:r,pad:n,lineHeight:i}=e,s=11,a=20+s,l=[`<line x1="0" y1="${o}" x2="${r}" y2="${o}" stroke="#d0d7de" stroke-width="1"/>`];return t.forEach((p,f)=>{let c=o+n+f*i+i/2;l.push(`<circle cx="${a}" cy="${c}" r="${s}" fill="#d1242f" stroke="#fff" stroke-width="1.5"/>`,`<text x="${a}" y="${c+4}" font-family="${M}" font-size="12" font-weight="700" fill="#fff" text-anchor="middle">${L(p.label)}</text>`,`<text x="${a+s+12}" y="${c+5}" font-family="${M}" font-size="14" fill="#1f2328">${L(p.text)}</text>`)}),l.join("")}async function xe(t){let e=JSON.parse(ve(t,"utf8"));if(!yt(e.rawPath))return{id:e.id,ok:!1,reason:`raw missing: ${e.rawPath}`};let o=await B(e.rawPath).metadata(),r=o.width??1440,n=o.height??900,i={pad:16,lineHeight:30},s=dt(e.annotations.length,i),a=n+s,l=[];for(let c of e.highlight)l.push(ut(c.bbox));for(let c of e.redact)l.push(ft(c.bbox));for(let c of e.annotations)l.push(gt(c.label,c.bbox,r,n));if(s>0&&l.push(`<rect x="0" y="${n}" width="${r}" height="${s}" fill="#ffffff"/>`,mt(e.annotations.map(c=>({label:c.label,text:c.text})),{top:n,width:r,...i})),l.length===0)return await B(e.rawPath).toFile(e.finalPath),{id:e.id,ok:!0,finalPath:e.finalPath};let p=`<svg xmlns="http://www.w3.org/2000/svg" width="${r}" height="${a}">${l.join("")}</svg>`,f=B(e.rawPath);return s>0&&(f=f.extend({bottom:s,background:"#ffffff"})),await f.composite([{input:Buffer.from(p),top:0,left:0}]).toFile(e.finalPath),{id:e.id,ok:!0,finalPath:e.finalPath}}async function ht(t){let e=wt(t).filter(r=>r.endsWith(".raw.png")),o=[];for(let r of e){let n=Pt(t,r),i=n.replace(/\.raw\.png$/,".png");try{$e(n,i),o.push({id:r.replace(/\.raw\.png$/,""),ok:!0,finalPath:i})}catch(s){o.push({id:r,ok:!1,reason:String(s)})}}return o}async function vt(t,e){if(!yt(t))return[];if(!e)return ht(t);let o=wt(t).filter(n=>n.endsWith(".annotations.json"));if(o.length===0)return ht(t);let r=[];for(let n of o){let i=Pt(t,n);try{r.push(await xe(i))}catch(s){r.push({id:n,ok:!1,reason:String(s)})}}return r}async function bt(t,e){let o=process.cwd(),r=m(d(o)),n=$(r,e.profile),i=n.name,s=x(r.projectId,i);if(!s.exists)return console.error(""),console.error(`\u2717 No saved session for profile "${i}".`),console.error(`  Expected at: ${s.path}`),console.error(`  Run: d360-capture auth --profile ${i}`),2;let a=$t(n.captureDir)?n.captureDir:xt(o,n.captureDir);if(!be(a))return console.error(`\u2717 Capture directory missing: ${a}`),console.error("  Generate at least one spec there before running capture."),2;let{configPath:l,tsconfigPath:p}=st({cwd:o,profileName:i,captureDir:n.captureDir,viewport:n.viewport,storageStatePath:R(r.projectId,i)}),f=t?[t]:Se(a);if(f.length===0)return console.error(`\u2717 No .spec.ts files in ${n.captureDir}.`),2;console.log(""),n.production&&console.log(`\u26A0 Profile "${i}" is PRODUCTION (read-only capture).`),console.log(`\u25B6 Running ${f.length} spec${f.length===1?"":"s"} against ${i} (${n.connection.startUrl})`),t||console.log("  Press Esc (or Ctrl+C) in this terminal to stop after the current spec; press again to stop now.");let c=!1,u=null,P=Ce(()=>{c?u?.abort():(c=!0,console.log(`
-\u23F8  Stopping after the current spec\u2026 (press again to stop now)`))}),w=[],y=!1;try{for(let g of f){if(c)break;u=new AbortController,console.log(`
-\u25B6 ${g}`);let I=await ct({cwd:o,configPath:l,tsconfigPath:p,startUrl:n.connection.startUrl,authBoundaryUrlPattern:n.connection.authBoundaryUrlPattern,specId:g,captureDirAbs:a,signal:u.signal,scope:n.scope});if(w.push({id:g,outcome:I.outcome}),I.exitCode!==0&&!y&&lt(`${I.stdout}
-${I.stderr}`)&&(y=!0,console.error(""),console.error("  Output mentions a login page \u2014 if specs that used to pass now fail this way, your"),console.error(`  saved session may have expired. Re-auth: d360-capture auth --profile ${i}`),console.error("  (Selector/route timeouts are spec bugs, not auth bugs \u2014 inspect the failure above.)")),u.signal.aborted)break}}finally{P(),u=null}let h=w.filter(g=>g.outcome==="passed").length,D=w.filter(g=>g.outcome==="failed"),S=w.filter(g=>g.outcome==="skipped"),A=f.length-w.length,H=!e.noAnnotate&&r.annotation.enabled,Et=$t(n.outputDir)?n.outputDir:xt(o,n.outputDir);console.log(""),console.log(H?"\u25B6 Annotating screenshots\u2026":"\u25B6 Skipping annotation (--no-annotate or config off)");let C=(await vt(Et,H)).filter(g=>!g.ok);console.log(""),console.log(`\u2713 ${h} captured`+(S.length?`  \xB7  \u2298 ${S.length} skipped`:"")+(D.length?`  \xB7  \u2717 ${D.length} failed`:"")+(A?`  \xB7  ${A} not run (stopped)`:"")+`  \u2192  ${n.outputDir}`);for(let g of S)console.log(`    \u2298 ${g.id}`);for(let g of D)console.log(`    \u2717 ${g.id}`);if(C.length>0){console.log(`\u2717 ${C.length} annotation failure${C.length===1?"":"s"}:`);for(let g of C)console.log(`    - ${g.id}: ${g.reason}`)}return D.length===0&&C.length===0?0:1}function Se(t){return De(t).filter(e=>e.endsWith(".spec.ts")).map(e=>e.slice(0,-8)).sort()}function Ce(t){let e=process.stdin;if(e.isTTY){let r=n=>{let i=n[0];(i===27||i===3||i===113||i===81)&&t()};return e.setRawMode(!0),e.resume(),e.on("data",r),()=>{e.off("data",r);try{e.setRawMode(!1)}catch{}e.pause()}}let o=()=>t();return process.on("SIGINT",o),()=>{process.off("SIGINT",o)}}import{existsSync as Dt,readdirSync as je,statSync as Re}from"node:fs";import{isAbsolute as St,join as ke,resolve as Ct}from"node:path";async function jt(){let t=process.cwd(),e=m(d(t)),o=St(e.captureDir)?e.captureDir:Ct(t,e.captureDir),r=St(e.outputDir)?e.outputDir:Ct(t,e.outputDir);if(!Dt(o)){console.log(`Capture dir does not exist: ${o}`);return}let n=je(o).filter(i=>i.endsWith(".spec.ts")).sort();if(n.length===0){console.log(`No specs found in ${e.captureDir}.`);return}console.log(""),console.log("  Spec ID                                         Last capture"),console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");for(let i of n){let s=i.replace(/\.spec\.ts$/,""),a=ke(r,`${s}.png`),l=Dt(a)?new Date(Re(a).mtimeMs).toISOString().slice(0,19).replace("T"," "):"(never)";console.log(`  ${s.padEnd(47)} ${l}`)}console.log("")}import{existsSync as Rt,readFileSync as kt}from"node:fs";import{isAbsolute as Ae,resolve as Ie}from"node:path";import{createRequire as Oe}from"node:module";var At=Oe(import.meta.url);async function It(t){let e=process.cwd(),o=0,r=c=>console.log(`  \u2713 ${c}`),n=c=>{console.log(`  \u2717 ${c}`),o++};console.log(""),console.log("Checking document360-capture setup..."),console.log("");let i=d(e);if(!Rt(i))return n(`Project config missing at ${i} \u2014 run \`d360-capture init\``),2;r(`Project config: ${i}`);let s;try{s=m(i),r(`Config parses; projectId="${s.projectId}"`)}catch(c){return n(`Config invalid: ${c.message}`),2}let a;try{a=$(s,t.profile),r(`Profile "${a.name}" resolved (startUrl=${a.connection.startUrl})${a.production?" \u26A0 PRODUCTION":""}`)}catch(c){return n(`Profile resolve failed: ${c.message}`),1}a.authBoundaryDefaulted&&r(`Auth boundary: ${a.connection.authBoundaryUrlPattern} (auto-derived from start URL; set connection.authBoundaryUrlPattern to override)`);let l=Ae(a.captureDir)?a.captureDir:Ie(e,a.captureDir);Rt(l)?r(`Capture dir exists: ${a.captureDir}`):n(`Capture dir missing: ${a.captureDir}`);let p=x(s.projectId,a.name);if(p.exists){let c=p.ageMs!=null?Math.floor(p.ageMs/864e5):null;r(`Auth-state present (${c}d old): ${p.path}`);try{let u=JSON.parse(kt(p.path,"utf8"));u&&typeof u=="object"?r("Auth-state parses as JSON"):n("Auth-state is not a valid object")}catch(u){n(`Auth-state unreadable: ${u.message}`)}}else n(`Auth-state missing for "${a.name}" \u2014 run \`d360-capture auth --profile ${a.name}\``);try{let c=At.resolve("playwright/package.json"),u=JSON.parse(kt(c,"utf8"));r(`playwright@${u.version} installed`)}catch{n("playwright not resolvable \u2014 reinstall document360-capture")}return["@playwright/test/cli","@playwright/test/cli.js"].some(c=>{try{return At.resolve(c),!0}catch{return!1}})?r("@playwright/test CLI resolvable"):n("@playwright/test CLI not resolvable \u2014 reinstall document360-capture"),console.log(""),console.log(o===0?"All checks passed.":`${o} check${o===1?"":"s"} failed.`),console.log(""),o===0?0:1}async function Ot(){let t=m(d());console.log(""),console.log(`projectId:           ${t.projectId}`),console.log(`captureDir:          ${t.captureDir}   (default)`),console.log(`outputDir:           ${t.outputDir}   (default)`),console.log(`viewport:            ${t.viewport.width}x${t.viewport.height}   (default)`),console.log(`annotation enabled:  ${t.annotation.enabled}`),console.log(`defaultProfile:      ${t.defaultProfile}`),console.log(""),console.log("Profiles:");for(let[e,o]of Object.entries(t.profiles)){let r=x(t.projectId,e),n=r.exists?`auth saved ${r.ageMs!=null?Math.floor(r.ageMs/864e5)+"d ago":""}`:"no auth-state",i=`${e===t.defaultProfile?" \u25CF":""}${o.production?" \u26A0 PRODUCTION":""}`;console.log(`  ${e.padEnd(10)}  ${o.connection.startUrl}${i}`),o.captureDir&&console.log(`              captureDir: ${o.captureDir}`),console.log(`              ${n}`)}console.log("")}function Ut(){let t=m(d());console.log("");for(let[e,o]of Object.entries(t.profiles)){let r=e===t.defaultProfile?"\u25CF ":"  ",n=o.production?" \u26A0 PRODUCTION":"",s=x(t.projectId,e).exists?"auth saved":"no auth-state";console.log(`${r}${e} \u2192 ${o.connection.startUrl}${n}  [${s}]`)}console.log(""),console.log("\u25CF = default. Switch with: d360-capture profile use <name>"),console.log("")}function Nt(t){let e=d(),o=m(e);if(!o.profiles[t])return console.error(`\u2717 Unknown profile "${t}". Available: ${Object.keys(o.profiles).join(", ")}`),1;o.defaultProfile=t,O(e,o);let r=o.profiles[t].production?" \u26A0 PRODUCTION":"";return console.log(`\u2713 Default profile is now "${t}"${r}`),0}function Tt(t){let e=m(d()),o=$(e,t);console.log(""),console.log(`Profile ${o.name}${o.production?" \u26A0 PRODUCTION":""}`),console.log(`  startUrl:    ${o.connection.startUrl}`),console.log(`  authBoundary:${o.connection.authBoundaryUrlPattern}`),console.log(`  captureDir:  ${o.captureDir}`),console.log(`  outputDir:   ${o.outputDir}`),console.log(`  viewport:    ${o.viewport.width}x${o.viewport.height}`);let r=Object.keys(o.scope);return r.length>0&&console.log(`  scope:       ${r.map(n=>`${n}=${o.scope[n]}`).join(", ")}`),console.log(""),0}var Te=Ne(import.meta.url),Ee=Te("../package.json"),v=new Ue;function _(t){t.env&&(console.error("\u2717 --env was replaced by --profile (connection profiles). Use: --profile <name>"),process.exit(2))}v.name("d360-capture").description("Capture product screenshots from Playwright specs. Login once, capture many.").version(Ee.version);v.command("init").description("Setup. Inherits from .d360-writer/config.json when present; asks only the app URL. Writes .d360-writer/capture.json.").option("-y, --yes","Non-interactive: scaffold with defaults + a placeholder URL, no prompts").action(async t=>{await V(t)});v.command("auth").description("Open Chromium for interactive login. Press ENTER when done to save the session.").option("-p, --profile <name>","Profile name (default: defaultProfile from config)").option("-e, --env <name>",!1).action(async t=>{_(t),await et(t)});v.command("capture [spec-id]").description("Run one spec by id, or all specs if omitted.").option("-p, --profile <name>","Profile name (default: defaultProfile from config)").option("-e, --env <name>",!1).option("--no-annotate","Skip annotation overlay; emit raw screenshots only").action(async(t,e)=>{_(e);let o=await bt(t,e);o!==0&&process.exit(o)});v.command("list").description("List discovered specs and their last-capture times.").action(async()=>{await jt()});v.command("doctor").description("Validate config, auth-state, and browser install.").option("-p, --profile <name>","Profile to check").option("-e, --env <name>",!1).action(async t=>{_(t);let e=await It(t);e!==0&&process.exit(e)});v.command("status").description("Print resolved config and auth-state freshness.").action(async()=>{await Ot()});var F=v.command("profile").description("Manage capture profiles for the current repo");F.command("list",{isDefault:!0}).description("List profiles (\u25CF = default)").action(()=>Ut());F.command("use <name>").description("Set the default profile for this repo").action(t=>process.exit(Nt(t)));F.command("show [name]").description("Print the resolved profile").action(t=>process.exit(Tt(t)));v.parseAsync(process.argv).catch(t=>{console.error(""),console.error(`\u2717 ${t.message}`),process.exit(1)});
+`;rt(a,c,"utf8");let u=k(s,`tsconfig.${o}.json`),P=A=>A.replace(/\\/g,"/"),y=T.resolve("document360-capture/helpers"),w=k(T.resolve("@playwright/test/package.json"),".."),h=k(w,"index.mjs"),S=nt(h)?h:f,C={compilerOptions:{baseUrl:".",paths:{"document360-capture/helpers":[P(y)],"@playwright/test":[P(S)]}}};return rt(u,JSON.stringify(C,null,2),"utf8"),{configPath:a,tsconfigPath:u}}import{spawn as ue}from"node:child_process";import{existsSync as fe}from"node:fs";import{createRequire as ge}from"node:module";import{fileURLToPath as de}from"node:url";import{delimiter as me,dirname as E,join as ct}from"node:path";function he(t,e){return t!==0?"failed":/\b\d+\s+skipped\b/.test(e)&&!/\b\d+\s+passed\b/.test(e)?"skipped":"passed"}var ye=ge(import.meta.url);async function lt(t){let{cwd:e,configPath:o,tsconfigPath:r,startUrl:n,authBoundaryUrlPattern:i,specId:s,captureDirAbs:a}=t,l=ve();if(!l)return{exitCode:127,stdout:"",stderr:"Cannot locate @playwright/test CLI. Try: npm install -g document360-capture (reinstall)",outcome:"failed"};let p=[l,"test","--config",o,"--tsconfig",r];return s&&p.push(we(`${s}.spec.ts`)),new Promise(f=>{let c="",u="",P=ue(process.execPath,p,{cwd:e,env:{...process.env,CAPTURE_START_URL:n,CAPTURE_AUTH_BOUNDARY:i,CAPTURE_SCOPE:JSON.stringify(t.scope??{}),NODE_PATH:Pe()},shell:!1}),y=()=>{try{P.kill()}catch{}};t.signal&&(t.signal.aborted?y():t.signal.addEventListener("abort",y,{once:!0})),P.stdout.on("data",w=>{let h=w.toString();c+=h,process.stdout.write(h)}),P.stderr.on("data",w=>{let h=w.toString();u+=h,process.stderr.write(h)}),P.on("error",w=>{t.signal?.removeEventListener("abort",y),u+=`
+[spawn error] ${w.message}`,f({exitCode:127,stdout:c,stderr:u,outcome:"failed"})}),P.on("close",w=>{t.signal?.removeEventListener("abort",y);let h=w??1;f({exitCode:h,stdout:c,stderr:u,outcome:he(h,c)})})})}function we(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function Pe(){let t=E(de(import.meta.url));for(let o=0;o<4&&!fe(ct(t,"package.json"));o++)t=E(t);let e=[ct(t,"node_modules"),E(t)];return process.env.NODE_PATH&&e.push(process.env.NODE_PATH),e.join(me)}function ve(){let t=["@playwright/test/cli","@playwright/test/cli.js","playwright/cli","playwright/cli.js"];for(let e of t)try{return ye.resolve(e)}catch{}return null}var $e=[/login\.microsoftonline\.com/i,/login\.live\.com/i,/accounts\.google\.com/i,/\/oauth(2)?\/authorize/i,/\/sign[- ]?in/i,/\bauthn\b/i],xe=[/waitForURL.*timed?[- ]?out/i,/page\.goto.*redirected/i,/storageState.*invalid/i];function pt(t){return $e.some(e=>e.test(t))?!0:xe.some(e=>e.test(t))}import{readdirSync as wt,readFileSync as Se,existsSync as Pt,copyFileSync as Ce}from"node:fs";import{join as vt}from"node:path";import B from"sharp";function L(t){return t.replace(/[<>&"']/g,e=>({"<":"&lt;",">":"&gt;","&":"&amp;",'"':"&quot;","'":"&apos;"})[e])}function ft(t){let o=Math.max(0,t.x-4),r=Math.max(0,t.y-4),n=t.width+8,i=t.height+8;return`<rect x="${o}" y="${r}" width="${n}" height="${i}" rx="6" ry="6" fill="rgba(255,213,0,0.18)" stroke="#f5a623" stroke-width="2.5"/>`}function gt(t){return`<rect x="${t.x}" y="${t.y}" width="${t.width}" height="${t.height}" fill="#1f2328"/>`}var M="-apple-system,Segoe UI,sans-serif",ut=(t,e,o)=>Math.max(e,Math.min(o,t)),be=13;function dt(t,e,o,r){let n=be,i=ut(e.x,n,Math.max(n,o-n)),s=ut(e.y,n,Math.max(n,r-n));return`<circle cx="${i}" cy="${s}" r="${n}" fill="#d1242f" stroke="#fff" stroke-width="2"/><text x="${i}" y="${s+4}" font-family="${M}" font-size="13" font-weight="700" fill="#fff" text-anchor="middle">${L(t)}</text>`}function mt(t,e){return t===0?0:e.pad*2+t*e.lineHeight}function ht(t,e){let{top:o,width:r,pad:n,lineHeight:i}=e,s=11,a=20+s,l=[`<line x1="0" y1="${o}" x2="${r}" y2="${o}" stroke="#d0d7de" stroke-width="1"/>`];return t.forEach((p,f)=>{let c=o+n+f*i+i/2;l.push(`<circle cx="${a}" cy="${c}" r="${s}" fill="#d1242f" stroke="#fff" stroke-width="1.5"/>`,`<text x="${a}" y="${c+4}" font-family="${M}" font-size="12" font-weight="700" fill="#fff" text-anchor="middle">${L(p.label)}</text>`,`<text x="${a+s+12}" y="${c+5}" font-family="${M}" font-size="14" fill="#1f2328">${L(p.text)}</text>`)}),l.join("")}async function De(t){let e=JSON.parse(Se(t,"utf8"));if(!Pt(e.rawPath))return{id:e.id,ok:!1,reason:`raw missing: ${e.rawPath}`};let o=await B(e.rawPath).metadata(),r=o.width??1440,n=o.height??900,i={pad:16,lineHeight:30},s=mt(e.annotations.length,i),a=n+s,l=[];for(let c of e.highlight)l.push(ft(c.bbox));for(let c of e.redact)l.push(gt(c.bbox));for(let c of e.annotations)l.push(dt(c.label,c.bbox,r,n));if(s>0&&l.push(`<rect x="0" y="${n}" width="${r}" height="${s}" fill="#ffffff"/>`,ht(e.annotations.map(c=>({label:c.label,text:c.text})),{top:n,width:r,...i})),l.length===0)return await B(e.rawPath).toFile(e.finalPath),{id:e.id,ok:!0,finalPath:e.finalPath};let p=`<svg xmlns="http://www.w3.org/2000/svg" width="${r}" height="${a}">${l.join("")}</svg>`,f=B(e.rawPath);return s>0&&(f=f.extend({bottom:s,background:"#ffffff"})),await f.composite([{input:Buffer.from(p),top:0,left:0}]).toFile(e.finalPath),{id:e.id,ok:!0,finalPath:e.finalPath}}async function yt(t){let e=wt(t).filter(r=>r.endsWith(".raw.png")),o=[];for(let r of e){let n=vt(t,r),i=n.replace(/\.raw\.png$/,".png");try{Ce(n,i),o.push({id:r.replace(/\.raw\.png$/,""),ok:!0,finalPath:i})}catch(s){o.push({id:r,ok:!1,reason:String(s)})}}return o}async function $t(t,e){if(!Pt(t))return[];if(!e)return yt(t);let o=wt(t).filter(n=>n.endsWith(".annotations.json"));if(o.length===0)return yt(t);let r=[];for(let n of o){let i=vt(t,n);try{r.push(await De(i))}catch(s){r.push({id:n,ok:!1,reason:String(s)})}}return r}async function St(t,e){let o=process.cwd(),r=m(d(o)),n=$(r,e.profile),i=n.name,s=x(r.projectId,i);if(!s.exists)return console.error(""),console.error(`\u2717 No saved session for profile "${i}".`),console.error(`  Expected at: ${s.path}`),console.error(`  Run: d360-capture auth --profile ${i}`),2;let a=xt(n.captureDir)?n.captureDir:bt(o,n.captureDir);if(!je(a))return console.error(`\u2717 Capture directory missing: ${a}`),console.error("  Generate at least one spec there before running capture."),2;let{configPath:l,tsconfigPath:p}=at({cwd:o,profileName:i,captureDir:n.captureDir,viewport:n.viewport,storageStatePath:R(r.projectId,i)}),f=t?[t]:ke(a);if(f.length===0)return console.error(`\u2717 No .spec.ts files in ${n.captureDir}.`),2;console.log(""),n.production&&console.log(`\u26A0 Profile "${i}" is PRODUCTION (read-only capture).`),console.log(`\u25B6 Running ${f.length} spec${f.length===1?"":"s"} against ${i} (${n.connection.startUrl})`),t||console.log("  Press Esc (or Ctrl+C) in this terminal to stop after the current spec; press again to stop now.");let c=!1,u=null,P=Ae(()=>{c?u?.abort():(c=!0,console.log(`
+\u23F8  Stopping after the current spec\u2026 (press again to stop now)`))}),y=[],w=!1;try{for(let g of f){if(c)break;u=new AbortController,console.log(`
+\u25B6 ${g}`);let I=await lt({cwd:o,configPath:l,tsconfigPath:p,startUrl:n.connection.startUrl,authBoundaryUrlPattern:n.connection.authBoundaryUrlPattern,specId:g,captureDirAbs:a,signal:u.signal,scope:n.scope});if(y.push({id:g,outcome:I.outcome}),I.exitCode!==0&&!w&&pt(`${I.stdout}
+${I.stderr}`)&&(w=!0,console.error(""),console.error("  Output mentions a login page \u2014 if specs that used to pass now fail this way, your"),console.error(`  saved session may have expired. Re-auth: d360-capture auth --profile ${i}`),console.error("  (Selector/route timeouts are spec bugs, not auth bugs \u2014 inspect the failure above.)")),u.signal.aborted)break}}finally{P(),u=null}let h=y.filter(g=>g.outcome==="passed").length,S=y.filter(g=>g.outcome==="failed"),C=y.filter(g=>g.outcome==="skipped"),A=f.length-y.length,H=!e.noAnnotate&&r.annotation.enabled,_t=xt(n.outputDir)?n.outputDir:bt(o,n.outputDir);console.log(""),console.log(H?"\u25B6 Annotating screenshots\u2026":"\u25B6 Skipping annotation (--no-annotate or config off)");let D=(await $t(_t,H)).filter(g=>!g.ok);console.log(""),console.log(`\u2713 ${h} captured`+(C.length?`  \xB7  \u2298 ${C.length} skipped`:"")+(S.length?`  \xB7  \u2717 ${S.length} failed`:"")+(A?`  \xB7  ${A} not run (stopped)`:"")+`  \u2192  ${n.outputDir}`);for(let g of C)console.log(`    \u2298 ${g.id}`);for(let g of S)console.log(`    \u2717 ${g.id}`);if(D.length>0){console.log(`\u2717 ${D.length} annotation failure${D.length===1?"":"s"}:`);for(let g of D)console.log(`    - ${g.id}: ${g.reason}`)}return S.length===0&&D.length===0?0:1}function ke(t){return Re(t).filter(e=>e.endsWith(".spec.ts")).map(e=>e.slice(0,-8)).sort()}function Ae(t){let e=process.stdin;if(e.isTTY){let r=n=>{let i=n[0];(i===27||i===3||i===113||i===81)&&t()};return e.setRawMode(!0),e.resume(),e.on("data",r),()=>{e.off("data",r);try{e.setRawMode(!1)}catch{}e.pause()}}let o=()=>t();return process.on("SIGINT",o),()=>{process.off("SIGINT",o)}}import{existsSync as Ct,readdirSync as Ie,statSync as Oe}from"node:fs";import{isAbsolute as Dt,join as Ue,resolve as jt}from"node:path";async function Rt(){let t=process.cwd(),e=m(d(t)),o=Dt(e.captureDir)?e.captureDir:jt(t,e.captureDir),r=Dt(e.outputDir)?e.outputDir:jt(t,e.outputDir);if(!Ct(o)){console.log(`Capture dir does not exist: ${o}`);return}let n=Ie(o).filter(i=>i.endsWith(".spec.ts")).sort();if(n.length===0){console.log(`No specs found in ${e.captureDir}.`);return}console.log(""),console.log("  Spec ID                                         Last capture"),console.log("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");for(let i of n){let s=i.replace(/\.spec\.ts$/,""),a=Ue(r,`${s}.png`),l=Ct(a)?new Date(Oe(a).mtimeMs).toISOString().slice(0,19).replace("T"," "):"(never)";console.log(`  ${s.padEnd(47)} ${l}`)}console.log("")}import{existsSync as kt,readFileSync as At}from"node:fs";import{isAbsolute as Ne,resolve as Te}from"node:path";import{createRequire as Ee}from"node:module";var It=Ee(import.meta.url);async function Ot(t){let e=process.cwd(),o=0,r=c=>console.log(`  \u2713 ${c}`),n=c=>{console.log(`  \u2717 ${c}`),o++};console.log(""),console.log("Checking document360-capture setup..."),console.log("");let i=d(e);if(!kt(i))return n(`Project config missing at ${i} \u2014 run \`d360-capture init\``),2;r(`Project config: ${i}`);let s;try{s=m(i),r(`Config parses; projectId="${s.projectId}"`)}catch(c){return n(`Config invalid: ${c.message}`),2}let a;try{a=$(s,t.profile),r(`Profile "${a.name}" resolved (startUrl=${a.connection.startUrl})${a.production?" \u26A0 PRODUCTION":""}`)}catch(c){return n(`Profile resolve failed: ${c.message}`),1}a.authBoundaryDefaulted&&r(`Auth boundary: ${a.connection.authBoundaryUrlPattern} (auto-derived from start URL; set connection.authBoundaryUrlPattern to override)`);let l=Ne(a.captureDir)?a.captureDir:Te(e,a.captureDir);kt(l)?r(`Capture dir exists: ${a.captureDir}`):n(`Capture dir missing: ${a.captureDir}`);let p=x(s.projectId,a.name);if(p.exists){let c=p.ageMs!=null?Math.floor(p.ageMs/864e5):null;r(`Auth-state present (${c}d old): ${p.path}`);try{let u=JSON.parse(At(p.path,"utf8"));u&&typeof u=="object"?r("Auth-state parses as JSON"):n("Auth-state is not a valid object")}catch(u){n(`Auth-state unreadable: ${u.message}`)}}else n(`Auth-state missing for "${a.name}" \u2014 run \`d360-capture auth --profile ${a.name}\``);try{let c=It.resolve("playwright/package.json"),u=JSON.parse(At(c,"utf8"));r(`playwright@${u.version} installed`)}catch{n("playwright not resolvable \u2014 reinstall document360-capture")}return["@playwright/test/cli","@playwright/test/cli.js"].some(c=>{try{return It.resolve(c),!0}catch{return!1}})?r("@playwright/test CLI resolvable"):n("@playwright/test CLI not resolvable \u2014 reinstall document360-capture"),console.log(""),console.log(o===0?"All checks passed.":`${o} check${o===1?"":"s"} failed.`),console.log(""),o===0?0:1}async function Ut(){let t=m(d());console.log(""),console.log(`projectId:           ${t.projectId}`),console.log(`captureDir:          ${t.captureDir}   (default)`),console.log(`outputDir:           ${t.outputDir}   (default)`),console.log(`viewport:            ${t.viewport.width}x${t.viewport.height}   (default)`),console.log(`annotation enabled:  ${t.annotation.enabled}`),console.log(`defaultProfile:      ${t.defaultProfile}`),console.log(""),console.log("Profiles:");for(let[e,o]of Object.entries(t.profiles)){let r=x(t.projectId,e),n=r.exists?`auth saved ${r.ageMs!=null?Math.floor(r.ageMs/864e5)+"d ago":""}`:"no auth-state",i=`${e===t.defaultProfile?" \u25CF":""}${o.production?" \u26A0 PRODUCTION":""}`;console.log(`  ${e.padEnd(10)}  ${o.connection.startUrl}${i}`),o.captureDir&&console.log(`              captureDir: ${o.captureDir}`),console.log(`              ${n}`)}console.log("")}function Nt(){let t=m(d());console.log("");for(let[e,o]of Object.entries(t.profiles)){let r=e===t.defaultProfile?"\u25CF ":"  ",n=o.production?" \u26A0 PRODUCTION":"",s=x(t.projectId,e).exists?"auth saved":"no auth-state";console.log(`${r}${e} \u2192 ${o.connection.startUrl}${n}  [${s}]`)}console.log(""),console.log("\u25CF = default. Switch with: d360-capture profile use <name>"),console.log("")}function Tt(t){let e=d(),o=m(e);if(!o.profiles[t])return console.error(`\u2717 Unknown profile "${t}". Available: ${Object.keys(o.profiles).join(", ")}`),1;o.defaultProfile=t,O(e,o);let r=o.profiles[t].production?" \u26A0 PRODUCTION":"";return console.log(`\u2713 Default profile is now "${t}"${r}`),0}function Et(t){let e=m(d()),o=$(e,t);console.log(""),console.log(`Profile ${o.name}${o.production?" \u26A0 PRODUCTION":""}`),console.log(`  startUrl:    ${o.connection.startUrl}`),console.log(`  authBoundary:${o.connection.authBoundaryUrlPattern}`),console.log(`  captureDir:  ${o.captureDir}`),console.log(`  outputDir:   ${o.outputDir}`),console.log(`  viewport:    ${o.viewport.width}x${o.viewport.height}`);let r=Object.keys(o.scope);return r.length>0&&console.log(`  scope:       ${r.map(n=>`${n}=${o.scope[n]}`).join(", ")}`),console.log(""),0}import{homedir as Le}from"node:os";import{join as Me,dirname as Be}from"node:path";import{mkdirSync as _e,readFileSync as Fe,writeFileSync as Je}from"node:fs";var Lt="document360-capture",_=Me(Le(),".document360-capture","update-cache.json"),He=10800*1e3;function We(t,e){let o=i=>{let[s="",a=""]=i.trim().replace(/^v/,"").split("-",2),l=s.split(".").map(p=>parseInt(p,10)||0);return{n:[l[0]??0,l[1]??0,l[2]??0],pre:a}},r=o(t),n=o(e);for(let i=0;i<3;i++)if(r.n[i]!==n.n[i])return r.n[i]<n.n[i]?-1:1;return r.pre===n.pre?0:r.pre?n.pre?r.pre<n.pre?-1:1:-1:1}function qe(){try{return JSON.parse(Fe(_,"utf8"))}catch{return null}}function Ge(){let t=(process.argv[1]??"").replace(/\\/g,"/");return/\/_npx\//.test(t)||/\/packages\/capture\//.test(t)?!1:/\/node_modules\/document360-capture\//.test(t)||!/\/packages\//.test(t)}async function ze(){try{let t=new AbortController,e=setTimeout(()=>t.abort(),2500),o=await fetch(`https://registry.npmjs.org/${Lt}/latest`,{signal:t.signal,headers:{accept:"application/json"}});if(clearTimeout(e),!o.ok)return;let r=await o.json(),n=typeof r.version=="string"?r.version:null;if(!n)return;_e(Be(_),{recursive:!0}),Je(_,`${JSON.stringify({checkedAt:new Date().toISOString(),latest:n})}
+`)}catch{}}function Mt(t){try{if(!Ge())return;let e=qe();e?.latest&&We(t,e.latest)<0&&console.error(`
+\u2B06 d360-capture ${t} \u2192 ${e.latest} available \u2014 run:  npm i -g ${Lt}@latest
+`),e?.checkedAt&&Date.now()-new Date(e.checkedAt).getTime()<He||ze()}catch{}}var Ye=Xe(import.meta.url),Bt=Ye("../package.json");Mt(Bt.version);var v=new Ke;function F(t){t.env&&(console.error("\u2717 --env was replaced by --profile (connection profiles). Use: --profile <name>"),process.exit(2))}v.name("d360-capture").description("Capture product screenshots from Playwright specs. Login once, capture many.").version(Bt.version);v.command("init").description("Setup. Inherits from .d360-writer/config.json when present; asks only the app URL. Writes .d360-writer/capture.json.").option("-y, --yes","Non-interactive: scaffold with defaults + a placeholder URL, no prompts").action(async t=>{await V(t)});v.command("auth").description("Open Chromium for interactive login. Press ENTER when done to save the session.").option("-p, --profile <name>","Profile name (default: defaultProfile from config)").option("-e, --env <name>",!1).action(async t=>{F(t),await ot(t)});v.command("capture [spec-id]").description("Run one spec by id, or all specs if omitted.").option("-p, --profile <name>","Profile name (default: defaultProfile from config)").option("-e, --env <name>",!1).option("--no-annotate","Skip annotation overlay; emit raw screenshots only").action(async(t,e)=>{F(e);let o=await St(t,e);o!==0&&process.exit(o)});v.command("list").description("List discovered specs and their last-capture times.").action(async()=>{await Rt()});v.command("doctor").description("Validate config, auth-state, and browser install.").option("-p, --profile <name>","Profile to check").option("-e, --env <name>",!1).action(async t=>{F(t);let e=await Ot(t);e!==0&&process.exit(e)});v.command("status").description("Print resolved config and auth-state freshness.").action(async()=>{await Ut()});var J=v.command("profile").description("Manage capture profiles for the current repo");J.command("list",{isDefault:!0}).description("List profiles (\u25CF = default)").action(()=>Nt());J.command("use <name>").description("Set the default profile for this repo").action(t=>process.exit(Tt(t)));J.command("show [name]").description("Print the resolved profile").action(t=>process.exit(Et(t)));v.parseAsync(process.argv).catch(t=>{console.error(""),console.error(`\u2717 ${t.message}`),process.exit(1)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document360-capture",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "CLI that captures product screenshots from Playwright specs. Login once, capture many. Companion to document360-writer.",
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "./helpers": "./dist/helpers/index.js"
   },
   "files": [
-    "dist",
+    "dist/**/*.js",
     "README.md",
     "LICENSE"
   ],

package/dist/annotate/compose.d.ts

@@ -1,7 +0,0 @@
-export type AnnotateResult = {
-    id: string;
-    ok: boolean;
-    reason?: string;
-    finalPath?: string;
-};
-export declare function composeAnnotations(outputDir: string, enabled: boolean): Promise<AnnotateResult[]>;

package/dist/annotate/svg.d.ts

@@ -1,32 +0,0 @@
-import type { Bbox } from '../helpers/types.js';
-export declare function escapeXml(s: string): string;
-export declare function highlightSvg(bbox: Bbox): string;
-export declare function redactSvg(bbox: Bbox): string;
-/**
- * Just the numbered pin, placed on the target's top-left corner (clamped into the image). Pins
- * only MARK targets — the explanation lives in the legend band — so they stay small and never
- * cover the surrounding UI, which is what doomed inline captions on busy screens.
- */
-export declare function pinSvg(label: string, bbox: Bbox, canvasW: number, canvasH: number): string;
-export type LegendItem = {
-    label: string;
-    text: string;
-};
-export type LegendLayout = {
-    /** Y where the band starts (== original image height). */
-    top: number;
-    width: number;
-    /** Vertical padding above the first / below the last entry. */
-    pad: number;
-    /** Per-entry row height. */
-    lineHeight: number;
-};
-/** Height a legend band needs for `n` entries — the canvas is extended by exactly this much. */
-export declare function legendBandHeight(n: number, layout: Pick<LegendLayout, 'pad' | 'lineHeight'>): number;
-/**
- * The legend band: a numbered list in the appended strip below the screenshot. Deterministic,
- * always-safe placement (the band is added space, so nothing on the page is ever covered) — no
- * collision detection or whitespace-hunting required. Each row reuses the pin's numbered chip so
- * the legend entry and its on-image pin read as the same marker.
- */
-export declare function legendSvg(items: LegendItem[], layout: LegendLayout): string;

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/commands/auth.d.ts

@@ -1,4 +0,0 @@
-export type AuthOptions = {
-    profile?: string;
-};
-export declare function authCommand(opts: AuthOptions): Promise<void>;

package/dist/commands/capture.d.ts

@@ -1,5 +0,0 @@
-export type CaptureOptions = {
-    profile?: string;
-    noAnnotate?: boolean;
-};
-export declare function captureCommand(specId: string | undefined, opts: CaptureOptions): Promise<number>;

package/dist/commands/doctor.d.ts

@@ -1,4 +0,0 @@
-export type DoctorOptions = {
-    profile?: string;
-};
-export declare function doctorCommand(opts: DoctorOptions): Promise<number>;

package/dist/commands/init.d.ts

@@ -1,5 +0,0 @@
-export type InitOptions = {
-    /** Non-interactive: scaffold with all defaults + a placeholder URL, asking nothing. */
-    yes?: boolean;
-};
-export declare function initCommand(opts?: InitOptions): Promise<void>;

package/dist/commands/list.d.ts

@@ -1 +0,0 @@
-export declare function listCommand(): Promise<void>;

package/dist/commands/profile.d.ts

@@ -1,3 +0,0 @@
-export declare function profileList(): void;
-export declare function profileUse(name: string): number;
-export declare function profileShow(name?: string): number;

package/dist/commands/status.d.ts

@@ -1 +0,0 @@
-export declare function statusCommand(): Promise<void>;

package/dist/config/authState.d.ts

@@ -1,10 +0,0 @@
-export declare function authStateDir(): string;
-export declare function authStatePath(projectId: string, profileName: string): string;
-export declare function ensureAuthStateDir(projectId: string): void;
-export type AuthStateInfo = {
-    path: string;
-    exists: boolean;
-    ageMs?: number;
-};
-export declare function getAuthStateInfo(projectId: string, profileName: string): AuthStateInfo;
-export declare function ensureParentDir(path: string): void;

package/dist/config/projectConfig.d.ts

@@ -1,117 +0,0 @@
-/** How to reach a target deployment for capture. On disk, only `startUrl` is required —
-    `authBoundaryUrlPattern` is filled by resolveProfile (host heuristic) when omitted. */
-export type ProfileConnection = {
-    startUrl: string;
-    authBoundaryUrlPattern?: string;
-};
-/** A named capture profile. `connection` is one aspect; a profile may also override
-    the directories/viewport so one repo can target multiple doc-sets/environments. */
-export type Profile = {
-    connection: ProfileConnection;
-    captureDir?: string;
-    outputDir?: string;
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    /** Visible warning only — capture is read-only (screenshots), so no hard guard. */
-    production?: boolean;
-    /** The prepared "demo" context a capture run targets, as generic key→value pairs the writer
-        recommends per product (NOT hardcoded to one product's notions). FlowForge → {project:"…"};
-        Document360 → {project,workspace,language}; others → {org}/{site}/… Injected to specs as
-        CAPTURE_SCOPE; specs read it via the captureScope() helper to navigate deterministically. */
-    scope?: Record<string, string>;
-};
-/**
- * The on-disk shape: a minimal `.d360-capture.json` need only carry a `profiles` map
- * whose profiles each have a `connection.startUrl`. Everything else is filled at load
- * time (see `DEFAULTS` + `normalizeProjectConfig`), so a 3-line config is valid.
- */
-export type RawProjectConfig = {
-    projectId?: string;
-    captureDir?: string;
-    outputDir?: string;
-    viewport?: {
-        width: number;
-        height: number;
-    };
-    loginTimeoutMs?: number;
-    annotation?: {
-        enabled: boolean;
-    };
-    profiles: Record<string, Profile>;
-    defaultProfile?: string;
-};
-/** A fully-resolved config: every default materialized. What every command sees. */
-export type ProjectConfig = {
-    projectId: string;
-    /** Defaults inherited by any profile that doesn't override them. */
-    captureDir: string;
-    outputDir: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    loginTimeoutMs: number;
-    annotation: {
-        enabled: boolean;
-    };
-    profiles: Record<string, Profile>;
-    defaultProfile: string;
-};
-/** A profile connection with the auth boundary resolved (always a string). */
-export type ResolvedConnection = {
-    startUrl: string;
-    authBoundaryUrlPattern: string;
-};
-/** A profile with directory/viewport defaults and the auth boundary already merged in. */
-export type ResolvedProfile = {
-    name: string;
-    connection: ResolvedConnection;
-    captureDir: string;
-    outputDir: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    production: boolean;
-    /** The capture scope (key→value) for this profile; {} when unset. */
-    scope: Record<string, string>;
-    /** True when the auth boundary was derived (host heuristic) rather than configured —
-        doctor surfaces this so a too-loose/tight pattern is refinable before it bites. */
-    authBoundaryDefaulted: boolean;
-};
-export declare const PROJECT_CONFIG_FILENAME: string;
-/** Filled in for any field a minimal config omits. Default location lives under .d360-writer/ to
-    match the writer's single-footprint layout (the capture dirs derive from the writer's docsDir
-    when present; these are the bare fallback). */
-export declare const DEFAULTS: {
-    readonly captureDir: ".d360-writer/user-docs/_capture";
-    readonly outputDir: ".d360-writer/user-docs/_screenshots";
-    readonly viewport: {
-        readonly width: 1440;
-        readonly height: 900;
-    };
-    readonly loginTimeoutMs: 0;
-    readonly annotation: {
-        readonly enabled: true;
-    };
-};
-export declare class ProfileConfigError extends Error {
-}
-export declare function findProjectConfigPath(cwd?: string): string;
-export declare function readProjectConfig(path: string): ProjectConfig;
-export declare function writeProjectConfig(path: string, cfg: RawProjectConfig): void;
-/**
- * Derive a permissive post-login auth boundary from the profile's start URL: any URL on the
- * same origin. The login/IdP flow legitimately leaves that origin (SSO redirects) and returns
- * to it once authenticated, so "back on the app origin" is a reasonable logged-in signal —
- * good enough as a default, refinable when it isn't. Falls back to match-anything if the URL
- * can't be parsed.
- */
-export declare function deriveAuthBoundary(startUrl: string): string;
-/** Fill every optional field from DEFAULTS / the cwd, then validate what can't be defaulted. */
-export declare function normalizeProjectConfig(raw: RawProjectConfig & {
-    environments?: unknown;
-}, path: string, cwd?: string): ProjectConfig;
-export declare function resolveProfile(cfg: ProjectConfig, name?: string): ResolvedProfile;

package/dist/config/userConfig.d.ts

@@ -1,6 +0,0 @@
-export type UserConfig = {
-    autoUpdate?: boolean;
-};
-export declare function userConfigPath(): string;
-export declare function readUserConfig(): UserConfig;
-export declare function writeUserConfig(cfg: UserConfig): void;

package/dist/config/writerConfigDefaults.d.ts

@@ -1,18 +0,0 @@
-/**
- * d360-capture rides on d360-writer's setup: when a repo already has `.d360-writer.json`,
- * `init` inherits its project label + doc directories so the only thing left to ask is the
- * live app URL. This reads that file as PLAIN JSON — never an engine import (the packages are
- * deliberately decoupled; this is file I/O, not a code dependency). Tolerant by design:
- * any parse/shape problem yields {} and init falls back to its own defaults.
- *
- * Field overlap is intentional — `.d360-writer.json` already carries `projectId`
- * (its doc comment: "scopes sessions/screenshots"), `captureDir`, `outputDir`, and `docsDir`.
- */
-export type WriterConfigDefaults = {
-    projectId?: string;
-    captureDir?: string;
-    outputDir?: string;
-};
-export declare function writerConfigPath(cwd?: string): string;
-export declare function hasWriterConfig(cwd?: string): boolean;
-export declare function readWriterConfigDefaults(cwd?: string): WriterConfigDefaults;

package/dist/helpers/dumpAnnotations.d.ts

@@ -1,3 +0,0 @@
-import type { Page } from '@playwright/test';
-import type { Placeholder } from './types.js';
-export declare function dumpAnnotations(page: Page, ph: Placeholder): Promise<void>;

package/dist/helpers/index.d.ts

@@ -1,4 +0,0 @@
-export { waitPastLogin } from './waitPastLogin.js';
-export { dumpAnnotations } from './dumpAnnotations.js';
-export { captureScope, scopeValue } from './scope.js';
-export type { Bbox, Annotation, Placeholder, ResolvedAnnotations } from './types.js';

package/dist/helpers/scope.d.ts

@@ -1,10 +0,0 @@
-/**
- * The prepared capture scope — generic key→value pairs (e.g. {project: "Docs Demo"}, or
- * {project, workspace, language} for products that scope that way) that the writer recommends
- * per product and the user fills in. document360-capture injects it to specs as CAPTURE_SCOPE
- * (JSON). Specs read it to navigate into a KNOWN context deterministically instead of grabbing
- * "the first one". Returns {} when unset, so single-context setups keep working.
- */
-export declare function captureScope(): Record<string, string>;
-/** One scope value, e.g. `scopeValue('project')`. Undefined when not configured. */
-export declare function scopeValue(key: string): string | undefined;

package/dist/helpers/types.d.ts

@@ -1,37 +0,0 @@
-export type Bbox = {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-};
-export type Annotation = {
-    target: string;
-    label: string;
-    text: string;
-};
-export type Placeholder = {
-    id: string;
-    saveTo: string;
-    highlight?: string[];
-    annotations?: Annotation[];
-    redact?: string[];
-};
-export type ResolvedAnnotations = {
-    id: string;
-    rawPath: string;
-    finalPath: string;
-    highlight: {
-        selector: string;
-        bbox: Bbox;
-    }[];
-    annotations: {
-        label: string;
-        text: string;
-        selector: string;
-        bbox: Bbox;
-    }[];
-    redact: {
-        selector: string;
-        bbox: Bbox;
-    }[];
-};

package/dist/helpers/waitPastLogin.d.ts

@@ -1,2 +0,0 @@
-import type { Page } from '@playwright/test';
-export declare function waitPastLogin(page: Page, pattern: RegExp, timeoutMs?: number): Promise<void>;

package/dist/runner/expiryDetect.d.ts

@@ -1 +0,0 @@
-export declare function looksLikeSessionExpiry(output: string): boolean;

package/dist/runner/playwrightConfig.d.ts

@@ -1,15 +0,0 @@
-export type RuntimeConfigArgs = {
-    cwd: string;
-    profileName: string;
-    captureDir: string;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    storageStatePath: string;
-};
-export type RuntimeConfigPaths = {
-    configPath: string;
-    tsconfigPath: string;
-};
-export declare function writeRuntimePlaywrightConfig(args: RuntimeConfigArgs): RuntimeConfigPaths;

package/dist/runner/runSpecs.d.ts

@@ -1,26 +0,0 @@
-export type RunSpecsArgs = {
-    cwd: string;
-    configPath: string;
-    tsconfigPath: string;
-    startUrl: string;
-    authBoundaryUrlPattern: string;
-    specId?: string;
-    captureDirAbs: string;
-    /** Abort the in-flight Playwright run (hard interrupt) — kills the child process. */
-    signal?: AbortSignal;
-    /** Prepared capture scope (key→value), passed to specs as CAPTURE_SCOPE (JSON). */
-    scope?: Record<string, string>;
-};
-export type RunOutcome = 'passed' | 'failed' | 'skipped';
-export type RunSpecsResult = {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-    /** Distinguishes a skipped spec (exit 0 + "skipped") from a real pass — so a prerequisite
-        skip isn't miscounted as a capture. */
-    outcome: RunOutcome;
-};
-/** Classify a single-spec run: nonzero → failed; else "skipped" only if Playwright reported a
-    skip and no pass; otherwise passed. (Per-spec mode runs exactly one test, so it's unambiguous.) */
-export declare function classifyOutcome(exitCode: number, stdout: string): RunOutcome;
-export declare function runSpecs(args: RunSpecsArgs): Promise<RunSpecsResult>;

package/dist/scripts/postinstall.d.ts

@@ -1 +0,0 @@
-export {};