waygraph 0.15.44 → 0.15.45

package/dist/analysis/coverage-gap.d.ts

@@ -1,4 +1,4 @@
-import type { BlockEntry } from "../auto-explore.js";
+import type { BlockEntry } from "../session/auto-explore.js";
 /** Collect selector strings from NavClick blocks and Block/*Sel source files. */
 export declare function collectKnownInteractionSelectors(projectDir: string, library: {
     navBlocks: BlockEntry[];

package/dist/analysis/coverage-gap.js

@@ -5,7 +5,7 @@
  */
 import { readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
-import { exploreRoots } from "../block-inject.js";
+import { exploreRoots } from "../session/block-inject.js";
 const SELECTOR_LITERAL = /(?:locator|visible|click|fill|press|selector|getByRole)\(\s*['"`]([^'"`]+)['"`]/g;
 const HASH_ID = /#([a-zA-Z][\w-]*)/g;
 const DATA_TEST = /\[data-test(?:-id)?(?:=["'`][^"'`]+["'`])?\]/g;

package/dist/analysis/graph.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join, dirname, relative, resolve } from "node:path";
 import { matchBlocksSelect, } from "../blocks-select.js";
-import { exploreRoots, injectTaggedFile } from "../block-inject.js";
+import { exploreRoots, injectTaggedFile } from "../session/block-inject.js";
 /**
  * Renders a `WaygraphGraph` as Mermaid `stateDiagram-v2` text - paste
  * straight into a `.md` file's ```mermaid fence or a live editor. `"*"`

package/dist/auto-session/helpers.d.ts

@@ -1,6 +1,6 @@
 import type { StubPhaseResult } from "../highlights.js";
-import type { BlockEntry, ExploreMenu } from "../auto-explore.js";
-import type { PickResult } from "../auto-explore-run.js";
+import type { BlockEntry, ExploreMenu } from "../session/auto-explore.js";
+import type { PickResult } from "../session/auto-explore-run.js";
 /** True when a stub-phase result actually carries authored content worth keeping. */
 export declare function stubPhaseHasContent(r: StubPhaseResult): boolean;
 export interface SessionSnapshotEdge {

package/dist/auto-session/session.js

@@ -1,10 +1,10 @@
 // Split out of the former 1,078-line auto-session.ts (see src/ARCHITECTURE.md). Behavior unchanged.
 import { CONSOLE_LOG_MAX_ENTRIES, FULL_MODE_DEFAULT_DEPTH, FULL_MODE_MAX_NODES, FULL_MODE_MAX_TEXT_LENGTH, TRACE_MAX_STEPS, buildSessionSnapshot, parsePick, stubFilePath, stubPhaseHasContent, walkFullDom } from "./helpers.js";
 import { instrumentPilotActions, installPersistentPilotOverlay, showPilotActivity, showPilotFixtures, showPilotVision, phaseToOverlayFixtures, describeOverlayFixtures, updatePilotOverlay } from "../pilot-overlay.js";
-import { buildExploreContext, buildExploreMenu } from "../auto-explore.js";
+import { buildExploreContext, buildExploreMenu } from "../session/auto-explore.js";
 import { MemPage } from "../mem-page.js";
 import { Engine } from "../engine.js";
-import { detectHere, ensureLivePage, ensureMem, resolveBaseUrl, runOneBlock, seedDefaultMem } from "../auto-explore-run.js";
+import { detectHere, ensureLivePage, ensureMem, resolveBaseUrl, runOneBlock, seedDefaultMem } from "../session/auto-explore-run.js";
 import { collectKnownInteractionSelectors, unmappedInteractionsPageScript } from "../analysis/coverage-gap.js";
 import { runStubPhase } from "../highlights.js";
 import { verboseLog } from "../verbose-log.js";

package/dist/cli/usage.d.ts

@@ -1,4 +1,4 @@
-import type { SessionMeta } from "../browser.js";
+import type { SessionMeta } from "../session/browser.js";
 export declare function printBrowserUsage(): void;
 export declare function printBrowserSessionsList(sessions: SessionMeta[], projectDir: string): void;
 export declare function usage(): void;

package/dist/commands/session.js

@@ -4,14 +4,14 @@ import { applyRunFlags, looksLikeFlowFileRef, parseRunFlags, resolveBaseUrl } fr
 import { runChain } from "../cli/run-chain.js";
 import { runChainAuto } from "./check.js";
 import { resolve } from "node:path";
-import { browserStart, listBrowserSessions, stopAllBrowserSessions, stopBrowserSession } from "../browser.js";
+import { browserStart, listBrowserSessions, stopAllBrowserSessions, stopBrowserSession } from "../session/browser.js";
 import { existsSync, statSync } from "node:fs";
-import { resolveInjectRoots } from "../block-inject.js";
-import { requestSession, resolveSessionMeta, runAttachLoop, runAutoServeCommand, spawnDetachedSession } from "../auto-session-ipc.js";
-import { pilotAttach, pilotStart } from "../pilot.js";
+import { resolveInjectRoots } from "../session/block-inject.js";
+import { requestSession, resolveSessionMeta, runAttachLoop, runAutoServeCommand, spawnDetachedSession } from "../session/auto-session-ipc.js";
+import { pilotAttach, pilotStart } from "../session/pilot.js";
 import { parseHighlightShorthand } from "../highlights/shorthand.js";
 import { isFileSelectToken, parseBlocksSelect } from "../blocks-select.js";
-import { runAutoExplore } from "../auto-explore-run.js";
+import { runAutoExplore } from "../session/auto-explore-run.js";
 import { discoverGraph, findOrphanBlocks, toMermaid } from "../analysis/graph.js";
 export async function sessionCase(args, command) {
     if (command === "browser") {

package/dist/index.d.ts

@@ -21,9 +21,9 @@ export { runTraverse } from "./traverse/run.js";
 export type { TraverseOptions, TraverseSessionMode, TraverseWorkerResult, } from "./traverse/run.js";
 export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport, } from "./traverse/coverage.js";
 export type { TraverseCoverageReport } from "./traverse/coverage.js";
-export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./overlay-beacon.js";
-export type { WgModalKind, WgBeaconRow } from "./overlay-beacon.js";
+export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./session/overlay-beacon.js";
+export type { WgModalKind, WgBeaconRow } from "./session/overlay-beacon.js";
 export { AutoSession, stubFilePath } from "./auto-session.js";
 export type { AutoSessionInit, SessionSnapshot, SessionSnapshotEdge, SessionSnapshotSection, ApplyPickResult, ApplyPathResult, TraceStep, ConsoleLogEntry, StorageSnapshot, ServiceWorkerRegistrationInfo, CookieInfo, StubFileKind, } from "./auto-session.js";
-export { pilotStart } from "./pilot.js";
-export type { PilotStartResult } from "./pilot.js";
+export { pilotStart } from "./session/pilot.js";
+export type { PilotStartResult } from "./session/pilot.js";

package/dist/index.js

@@ -11,6 +11,6 @@ export { isFileSelectToken, parseBlocksSelect, matchBlocksSelect, globToRegExp,
 export { EdgeLeaseCoordinator } from "./traverse/lease.js";
 export { runTraverse } from "./traverse/run.js";
 export { buildCoverageReport, collectGraphEdgeKeys, defaultCoverageOutPath, formatCoverageLine, normalizeHitKey, parseMinEdgeCoverage, writeCoverageReport, } from "./traverse/coverage.js";
-export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./overlay-beacon.js";
+export { WG_UI_SEL, WG_READY_PANEL_SEL, WG_READY_AUTO_SEL, WG_READY_BANNER_SEL, readWgOverlayBeacon, readWgOverlayBeaconInPage, assertWgOverlayReady, } from "./session/overlay-beacon.js";
 export { AutoSession, stubFilePath } from "./auto-session.js";
-export { pilotStart } from "./pilot.js";
+export { pilotStart } from "./session/pilot.js";

package/dist/session/auto-explore-run.d.ts

@@ -0,0 +1,37 @@
+import type { Page, BrowserContext } from "@playwright/test";
+import { Engine } from "../engine.js";
+import { MemPage } from "../mem-page.js";
+import { type BlockEntry } from "./auto-explore.js";
+import type { Checkpoint } from "../types.js";
+export interface AutoExploreOptions {
+    /** Terminal menu (browser still runs for act()). Default false = headful picker panel. */
+    cli?: boolean;
+    baseURL?: string;
+    /** Initial URL when the page is blank (defaults to baseURL). */
+    startUrl?: string;
+    /** Phase C: glob / regex / bare `--blocks` file select for discovery. */
+    blocksSelect?: import("../blocks-select.js").BlocksSelect;
+}
+export declare function resolveBaseUrl(projectDir: string): string | undefined;
+export declare function detectHere(page: Page, navBlocks: BlockEntry[]): Promise<string | null>;
+export declare function ensureLivePage(context: BrowserContext, page: Page, startUrl: string | undefined): Promise<Page>;
+/**
+ * Saucedemo-only defaults. Exact key names only — never substring `"login"`.
+ * A consumer's own `key<string>("login-email")` must stay unset here, or it
+ * silently gets a saucedemo credentials object instead of its own default.
+ */
+export declare function defaultMemValueForKey(keyName: string): unknown | undefined;
+/** Pre-seed known demo keys (saucedemo creds) so headful/cli do not stop for mem forms. */
+export declare function seedDefaultMem(library: Map<string, BlockEntry>, mem: MemPage): void;
+export declare function ensureMem(entry: BlockEntry, mem: MemPage, cli: boolean): Promise<void>;
+export declare function runOneBlock(engine: Engine, entry: BlockEntry, context: BrowserContext, page: Page, mem: MemPage, headful: boolean): Promise<Checkpoint<string>>;
+export type PickResult = {
+    type: "pick";
+    index: number;
+} | {
+    type: "quit";
+};
+/**
+ * Interactive waygraph auto: locate current Checkpoint, list runnable Blocks, pick one, repeat.
+ */
+export declare function runAutoExplore(projectDir: string, options?: AutoExploreOptions): Promise<void>;