libretto 0.2.7 → 0.3.0

package/dist/shared/config/config.cjs

@@ -1,44 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var config_exports = {};
-__export(config_exports, {
-  isDebugMode: () => isDebugMode,
-  isDryRun: () => isDryRun,
-  shouldPauseBeforeMutation: () => shouldPauseBeforeMutation
-});
-module.exports = __toCommonJS(config_exports);
-function isDebugMode() {
-  return process.env.LIBRETTO_DEBUG === "true";
-}
-function isDryRun() {
-  const explicit = process.env.LIBRETTO_DRY_RUN;
-  if (explicit !== void 0) {
-    return explicit === "true";
-  }
-  return process.env.NODE_ENV === "development";
-}
-function shouldPauseBeforeMutation() {
-  return isDryRun() && isDebugMode();
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-});

package/dist/shared/config/config.d.cts

@@ -1,10 +0,0 @@
-/**
- * Runtime configuration for libretto.
- *
- * Values are derived from environment variables only.
- */
-declare function isDebugMode(): boolean;
-declare function isDryRun(): boolean;
-declare function shouldPauseBeforeMutation(): boolean;
-
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation };

package/dist/shared/config/config.d.ts

@@ -1,10 +0,0 @@
-/**
- * Runtime configuration for libretto.
- *
- * Values are derived from environment variables only.
- */
-declare function isDebugMode(): boolean;
-declare function isDryRun(): boolean;
-declare function shouldPauseBeforeMutation(): boolean;
-
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation };

package/dist/shared/config/config.js

@@ -1,18 +0,0 @@
-function isDebugMode() {
-  return process.env.LIBRETTO_DEBUG === "true";
-}
-function isDryRun() {
-  const explicit = process.env.LIBRETTO_DRY_RUN;
-  if (explicit !== void 0) {
-    return explicit === "true";
-  }
-  return process.env.NODE_ENV === "development";
-}
-function shouldPauseBeforeMutation() {
-  return isDryRun() && isDebugMode();
-}
-export {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-};

package/dist/shared/config/index.cjs

@@ -1,32 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var config_exports = {};
-__export(config_exports, {
-  isDebugMode: () => import_config.isDebugMode,
-  isDryRun: () => import_config.isDryRun,
-  shouldPauseBeforeMutation: () => import_config.shouldPauseBeforeMutation
-});
-module.exports = __toCommonJS(config_exports);
-var import_config = require("./config.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-});

package/dist/shared/config/index.d.cts

@@ -1 +0,0 @@
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation } from './config.cjs';

package/dist/shared/config/index.d.ts

@@ -1 +0,0 @@
-export { isDebugMode, isDryRun, shouldPauseBeforeMutation } from './config.js';

package/dist/shared/config/index.js

@@ -1,10 +0,0 @@
-import {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-} from "./config.js";
-export {
-  isDebugMode,
-  isDryRun,
-  shouldPauseBeforeMutation
-};

package/dist/shared/debug/index.cjs

@@ -1,30 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var debug_exports = {};
-__export(debug_exports, {
-  pause: () => import_pause.pause,
-  setSessionForPause: () => import_pause.setSessionForPause
-});
-module.exports = __toCommonJS(debug_exports);
-var import_pause = require("./pause.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pause,
-  setSessionForPause
-});

package/dist/shared/debug/index.d.cts

@@ -1 +0,0 @@
-export { pause, setSessionForPause } from './pause.cjs';

package/dist/shared/debug/index.d.ts

@@ -1 +0,0 @@
-export { pause, setSessionForPause } from './pause.js';

package/dist/shared/debug/index.js

@@ -1,5 +0,0 @@
-import { pause, setSessionForPause } from "./pause.js";
-export {
-  pause,
-  setSessionForPause
-};

package/dist/shared/debug/pause.cjs

@@ -1,90 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var pause_exports = {};
-__export(pause_exports, {
-  pause: () => pause,
-  setSessionForPause: () => setSessionForPause
-});
-module.exports = __toCommonJS(pause_exports);
-var import_node_fs = require("node:fs");
-var import_promises = require("node:fs/promises");
-let _sessionName;
-function setSessionForPause(session) {
-  _sessionName = session;
-}
-function getSessionFromProcessArgs() {
-  const rawPayload = process.argv[2];
-  if (!rawPayload) return void 0;
-  try {
-    const parsed = JSON.parse(rawPayload);
-    return typeof parsed.session === "string" ? parsed.session : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function resolveSession() {
-  return _sessionName ?? getSessionFromProcessArgs();
-}
-async function pause() {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
-  const session = resolveSession();
-  if (!session) {
-    return;
-  }
-  const { getPauseSignalPaths, removeSignalIfExists } = await import("../../cli/core/pause-signals.js");
-  const { getSessionDir } = await import("../../cli/core/context.js");
-  const signalPaths = getPauseSignalPaths(session);
-  const { pausedSignalPath, resumeSignalPath } = signalPaths;
-  await (0, import_promises.mkdir)(getSessionDir(session), { recursive: true });
-  await removeSignalIfExists(resumeSignalPath);
-  const details = {
-    sessionName: session,
-    pausedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    url: "unknown"
-  };
-  await (0, import_promises.writeFile)(pausedSignalPath, JSON.stringify(details, null, 2), "utf8");
-  console.log(`[pause] Paused (session: ${session})`);
-  console.log("[pause] Waiting for resume signal...");
-  const RESUME_POLL_INTERVAL_MS = 250;
-  while (!(0, import_node_fs.existsSync)(resumeSignalPath)) {
-    await new Promise(
-      (resolve) => setTimeout(resolve, RESUME_POLL_INTERVAL_MS)
-    );
-  }
-  await removeSignalIfExists(resumeSignalPath);
-  await removeSignalIfExists(pausedSignalPath);
-  console.log("[pause] Resume signal received. Continuing workflow...");
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  pause,
-  setSessionForPause
-});

package/dist/shared/debug/pause.d.cts

@@ -1,16 +0,0 @@
-/**
- * Called by the CLI runtime to make the session name available to `pause()`.
- */
-declare function setSessionForPause(session: string): void;
-/**
- * Standalone pause function.
- *
- * - In production (`NODE_ENV === "production"`), returns immediately (no-op).
- * - Otherwise, writes a `.paused` signal file and polls for a `.resume` signal,
- *   using the same file-based mechanism as the CLI runner.
- *
- * Import directly: `import { pause } from "libretto";`
- */
-declare function pause(): Promise<void>;
-
-export { pause, setSessionForPause };

package/dist/shared/debug/pause.d.ts

@@ -1,16 +0,0 @@
-/**
- * Called by the CLI runtime to make the session name available to `pause()`.
- */
-declare function setSessionForPause(session: string): void;
-/**
- * Standalone pause function.
- *
- * - In production (`NODE_ENV === "production"`), returns immediately (no-op).
- * - Otherwise, writes a `.paused` signal file and polls for a `.resume` signal,
- *   using the same file-based mechanism as the CLI runner.
- *
- * Import directly: `import { pause } from "libretto";`
- */
-declare function pause(): Promise<void>;
-
-export { pause, setSessionForPause };

package/dist/shared/debug/pause.js

@@ -1,55 +0,0 @@
-import { existsSync } from "node:fs";
-import { mkdir, writeFile } from "node:fs/promises";
-let _sessionName;
-function setSessionForPause(session) {
-  _sessionName = session;
-}
-function getSessionFromProcessArgs() {
-  const rawPayload = process.argv[2];
-  if (!rawPayload) return void 0;
-  try {
-    const parsed = JSON.parse(rawPayload);
-    return typeof parsed.session === "string" ? parsed.session : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function resolveSession() {
-  return _sessionName ?? getSessionFromProcessArgs();
-}
-async function pause() {
-  if (process.env.NODE_ENV === "production") {
-    return;
-  }
-  const session = resolveSession();
-  if (!session) {
-    return;
-  }
-  const { getPauseSignalPaths, removeSignalIfExists } = await import("../../cli/core/pause-signals.js");
-  const { getSessionDir } = await import("../../cli/core/context.js");
-  const signalPaths = getPauseSignalPaths(session);
-  const { pausedSignalPath, resumeSignalPath } = signalPaths;
-  await mkdir(getSessionDir(session), { recursive: true });
-  await removeSignalIfExists(resumeSignalPath);
-  const details = {
-    sessionName: session,
-    pausedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    url: "unknown"
-  };
-  await writeFile(pausedSignalPath, JSON.stringify(details, null, 2), "utf8");
-  console.log(`[pause] Paused (session: ${session})`);
-  console.log("[pause] Waiting for resume signal...");
-  const RESUME_POLL_INTERVAL_MS = 250;
-  while (!existsSync(resumeSignalPath)) {
-    await new Promise(
-      (resolve) => setTimeout(resolve, RESUME_POLL_INTERVAL_MS)
-    );
-  }
-  await removeSignalIfExists(resumeSignalPath);
-  await removeSignalIfExists(pausedSignalPath);
-  console.log("[pause] Resume signal received. Continuing workflow...");
-}
-export {
-  pause,
-  setSessionForPause
-};

package/dist/shared/instrumentation/errors.cjs

@@ -1,81 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var errors_exports = {};
-__export(errors_exports, {
-  enrichTimeoutError: () => enrichTimeoutError
-});
-module.exports = __toCommonJS(errors_exports);
-async function enrichTimeoutError(err, locator, page) {
-  const reasons = [];
-  try {
-    const visible = await locator.isVisible().catch(() => null);
-    if (visible === false) {
-      reasons.push("Element is not visible");
-    }
-    if (typeof locator.isInViewport === "function") {
-      const inViewport = await locator.isInViewport().catch(() => null);
-      if (inViewport === false) {
-        reasons.push("Element is outside of the viewport");
-      }
-    }
-    const enabled = await locator.isEnabled().catch(() => null);
-    if (enabled === false) {
-      reasons.push("Element is not enabled (disabled)");
-    }
-    if (reasons.length === 0) {
-      const box = await locator.boundingBox().catch(() => null);
-      if (box) {
-        const centerX = box.x + box.width / 2;
-        const centerY = box.y + box.height / 2;
-        const interceptInfo = await page.evaluate(
-          ({ x, y }) => {
-            const els = document.elementsFromPoint(x, y);
-            if (!els || els.length < 2) return null;
-            const topEl = els[0];
-            if (!topEl) return null;
-            const tag = topEl.tagName.toLowerCase();
-            const id = topEl.id ? `#${topEl.id}` : "";
-            const cls = topEl.className ? `.${String(topEl.className).split(/\s+/).slice(0, 2).join(".")}` : "";
-            const text = (topEl.textContent || "").trim().slice(0, 40);
-            return {
-              tag,
-              preview: `<${tag}${id}${cls}>${text ? ` "${text}"` : ""}`
-            };
-          },
-          { x: centerX, y: centerY }
-        ).catch(() => null);
-        if (interceptInfo) {
-          reasons.push(
-            `Element may be intercepted by ${interceptInfo.preview}`
-          );
-        }
-      }
-    }
-  } catch {
-  }
-  if (reasons.length > 0) {
-    const enrichment = `
-[libretto diagnostics] ${reasons.join("; ")}`;
-    err.message = (err.message || "") + enrichment;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  enrichTimeoutError
-});

package/dist/shared/instrumentation/errors.d.cts

@@ -1,12 +0,0 @@
-import { Locator, Page } from 'playwright';
-
-/**
- * Enrich a timeout error from a pointer action (click/dblclick/hover) with
- * diagnostic information about why the action may have failed.
- *
- * Mutates err.message in-place to append the enrichment.
- * Best-effort: if any probe fails, we skip that check silently.
- */
-declare function enrichTimeoutError(err: any, locator: Locator, page: Page): Promise<void>;
-
-export { enrichTimeoutError };

package/dist/shared/instrumentation/errors.d.ts

@@ -1,12 +0,0 @@
-import { Locator, Page } from 'playwright';
-
-/**
- * Enrich a timeout error from a pointer action (click/dblclick/hover) with
- * diagnostic information about why the action may have failed.
- *
- * Mutates err.message in-place to append the enrichment.
- * Best-effort: if any probe fails, we skip that check silently.
- */
-declare function enrichTimeoutError(err: any, locator: Locator, page: Page): Promise<void>;
-
-export { enrichTimeoutError };

package/dist/shared/instrumentation/errors.js

@@ -1,57 +0,0 @@
-async function enrichTimeoutError(err, locator, page) {
-  const reasons = [];
-  try {
-    const visible = await locator.isVisible().catch(() => null);
-    if (visible === false) {
-      reasons.push("Element is not visible");
-    }
-    if (typeof locator.isInViewport === "function") {
-      const inViewport = await locator.isInViewport().catch(() => null);
-      if (inViewport === false) {
-        reasons.push("Element is outside of the viewport");
-      }
-    }
-    const enabled = await locator.isEnabled().catch(() => null);
-    if (enabled === false) {
-      reasons.push("Element is not enabled (disabled)");
-    }
-    if (reasons.length === 0) {
-      const box = await locator.boundingBox().catch(() => null);
-      if (box) {
-        const centerX = box.x + box.width / 2;
-        const centerY = box.y + box.height / 2;
-        const interceptInfo = await page.evaluate(
-          ({ x, y }) => {
-            const els = document.elementsFromPoint(x, y);
-            if (!els || els.length < 2) return null;
-            const topEl = els[0];
-            if (!topEl) return null;
-            const tag = topEl.tagName.toLowerCase();
-            const id = topEl.id ? `#${topEl.id}` : "";
-            const cls = topEl.className ? `.${String(topEl.className).split(/\s+/).slice(0, 2).join(".")}` : "";
-            const text = (topEl.textContent || "").trim().slice(0, 40);
-            return {
-              tag,
-              preview: `<${tag}${id}${cls}>${text ? ` "${text}"` : ""}`
-            };
-          },
-          { x: centerX, y: centerY }
-        ).catch(() => null);
-        if (interceptInfo) {
-          reasons.push(
-            `Element may be intercepted by ${interceptInfo.preview}`
-          );
-        }
-      }
-    }
-  } catch {
-  }
-  if (reasons.length > 0) {
-    const enrichment = `
-[libretto diagnostics] ${reasons.join("; ")}`;
-    err.message = (err.message || "") + enrichment;
-  }
-}
-export {
-  enrichTimeoutError
-};

package/dist/shared/instrumentation/index.cjs

@@ -1,35 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var instrumentation_exports = {};
-__export(instrumentation_exports, {
-  enrichTimeoutError: () => import_errors.enrichTimeoutError,
-  installInstrumentation: () => import_instrument.installInstrumentation,
-  instrumentContext: () => import_instrument.instrumentContext,
-  instrumentPage: () => import_instrument.instrumentPage
-});
-module.exports = __toCommonJS(instrumentation_exports);
-var import_instrument = require("./instrument.js");
-var import_errors = require("./errors.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  enrichTimeoutError,
-  installInstrumentation,
-  instrumentContext,
-  instrumentPage
-});

package/dist/shared/instrumentation/index.d.cts

@@ -1,6 +0,0 @@
-export { InstrumentationOptions, InstrumentedPage, installInstrumentation, instrumentContext, instrumentPage } from './instrument.cjs';
-export { enrichTimeoutError } from './errors.cjs';
-import 'playwright';
-import '../logger/logger.cjs';
-import '../visualization/ghost-cursor.cjs';
-import '../visualization/highlight.cjs';

package/dist/shared/instrumentation/index.d.ts

@@ -1,6 +0,0 @@
-export { InstrumentationOptions, InstrumentedPage, installInstrumentation, instrumentContext, instrumentPage } from './instrument.js';
-export { enrichTimeoutError } from './errors.js';
-import 'playwright';
-import '../logger/logger.js';
-import '../visualization/ghost-cursor.js';
-import '../visualization/highlight.js';

package/dist/shared/instrumentation/index.js

@@ -1,12 +0,0 @@
-import {
-  instrumentPage,
-  installInstrumentation,
-  instrumentContext
-} from "./instrument.js";
-import { enrichTimeoutError } from "./errors.js";
-export {
-  enrichTimeoutError,
-  installInstrumentation,
-  instrumentContext,
-  instrumentPage
-};