prowl-tools 0.1.5 → 0.1.7

package/dist/lib.js

@@ -1,25 +1,41 @@
 import {
+  ANDROID_INTERACTIVE_CLASSES,
   ANDROID_KEYCODES,
+  ANDROID_MATCH_DIALECT,
   DEFAULT_AGENT_REQUEST_TIMEOUT_MS,
   DEFAULT_ANALYZE_TREE_DEPTH,
   DEFAULT_FLAKY_THRESHOLD,
   DEFAULT_REQUEST_TIMEOUT_MS,
   DEFAULT_SIMULATOR_LOCK_ROOT,
   DEFAULT_WDA_REQUEST_TIMEOUT_MS,
+  HELPER_BINARY,
   INTERACTIVE_ROLES,
+  IOS_INTERACTIVE_TYPES,
+  IOS_MATCH_DIALECT,
   IOS_PRESS_KEYS,
+  IOS_WINDOW_TYPE,
+  MACDRIVER_REPO,
+  MACDRIVER_SIGNING_AUTHORITY_PREFIX,
+  MACDRIVER_SIGNING_IDENTIFIER,
+  MACDRIVER_VERSION,
+  MACDRIVER_VERSION_PATTERN,
+  MACOS_MATCH_DIALECT,
+  NATIVE_ATTRIBUTE_MAP,
   SpawnMacHelperClient,
   UIA2_REMOTE_PORT,
   Uia2HttpError,
   Uia2Transport,
-  WDA_RUNNER_APP_NAME,
   WDA_RUNNER_BUNDLE_ID,
+  WDA_USE_PORT_ENV,
   WEB_ONLY_STEP_TYPES,
   WdaHttpError,
   WdaTransport,
+  analyzeAndroidApp,
+  analyzeIosApp,
   analyzeMacApp,
   analyzePage,
   androidAppAllowedIdentities,
+  androidNodeToNative,
   androidQueryToLocator,
   assertAndroidAppAllowed,
   assertIosAppAllowed,
@@ -32,6 +48,8 @@ import {
   closeIosSession,
   closeMacSession,
   clusterFailures,
+  codesignVerifier,
+  collectMacdriverStatus,
   computeFlakeScore,
   createAndroidDriver,
   createIosDriver,
@@ -40,8 +58,12 @@ import {
   createUia2Session,
   createWdaAgentClient,
   createWdaSession,
+  decodeXmlEntities,
   defaultAgentConnector,
   defaultIosAgentConnector,
+  defaultWdaTestRunPreparer,
+  dittoExtractor,
+  downloadAndVerify,
   escapePredicateArg,
   escapeUiSelectorArg,
   extractElementId,
@@ -50,26 +72,54 @@ import {
   findFreePort,
   generateHunt,
   healSelector,
+  injectUsePortIntoXctestrun,
+  installMacdriver,
   interpolateHunt,
   iosAppAllowedIdentities,
+  iosNodeToNative,
   iosQueryToLocator,
+  isAndroidInteractive,
+  isIosInteractive,
   launchAndroidSession,
   launchIosSession,
   launchMacSession,
   listDevices,
   listSimulators,
+  macdriverAssetName,
+  macdriverAssetUrl,
   macdriverBuildInstructions,
+  macdriverChecksumName,
+  macdriverInstallRoot,
+  macdriverInstalledBinary,
+  macdriverReleaseTag,
+  macdriverVersionDir,
+  matchAndroidSelector,
+  matchIosSelector,
+  matchNativeTree,
+  nodeMatchesSelector,
   normalizeXcuiClassName,
   parseAaptPackage,
   parseAdbDevices,
+  parseAndroidHierarchy,
   parseAndroidSelector,
+  parseChecksumFile,
+  parseCodesignDetails,
   parseForwardPort,
+  parseIosHierarchy,
   parseIosSelector,
   parseMacSelector,
+  parseNativeSelector,
   parseSimctlDevices,
+  parseSnapshot,
   parseXcodeVersion,
+  parseXml,
+  qualifyResourceId,
+  quoteSelectorValue,
+  rankAndroidSelectors,
   rankFlaky,
+  rankIosSelectors,
   rankMacSelectors,
+  rankNativeSelectors,
   readHistory,
   readHuntHistory,
   readIosBundleIdentifier,
@@ -77,19 +127,30 @@ import {
   resolveAgentApks,
   resolveHelperBinary,
   resolveWdaProject,
-  resolveWdaRunner,
+  resolveWdaTestRun,
   runHunt,
   runSuite,
+  runVersionProbe,
   selectDeviceSerial,
   selectSimulatorUdid,
+  sha256Hex,
+  shortIosType,
+  tccGuidance,
+  unquoteSelectorValue,
   unwrapAndroidTextSelector,
   unwrapIosTextSelector,
+  unwrapNativeTextSelector,
   updateBacklogFromSuite,
+  validateMacdriverArchiveEntries,
+  validateMacdriverVersion,
+  verifyMacdriverSignature,
   waitForAgentReady,
   waitForWdaReady,
   wdaCacheDir,
-  webOnlyReason
-} from "./chunk-2KD2XCTH.js";
+  wdaTestRunArgs,
+  webOnlyReason,
+  zipinfoArchiveLister
+} from "./chunk-R7NUH44M.js";
 import {
   configSchema,
   huntSchema,
@@ -99,29 +160,45 @@ import {
   loadHuntMeta,
   loadHuntTags,
   stepSchema
-} from "./chunk-ITOSUJCN.js";
+} from "./chunk-O3OUTZ2P.js";
 export {
+  ANDROID_INTERACTIVE_CLASSES,
   ANDROID_KEYCODES,
+  ANDROID_MATCH_DIALECT,
   DEFAULT_AGENT_REQUEST_TIMEOUT_MS,
   DEFAULT_ANALYZE_TREE_DEPTH,
   DEFAULT_FLAKY_THRESHOLD,
   DEFAULT_REQUEST_TIMEOUT_MS,
   DEFAULT_SIMULATOR_LOCK_ROOT,
   DEFAULT_WDA_REQUEST_TIMEOUT_MS,
+  HELPER_BINARY,
   INTERACTIVE_ROLES,
+  IOS_INTERACTIVE_TYPES,
+  IOS_MATCH_DIALECT,
   IOS_PRESS_KEYS,
+  IOS_WINDOW_TYPE,
+  MACDRIVER_REPO,
+  MACDRIVER_SIGNING_AUTHORITY_PREFIX,
+  MACDRIVER_SIGNING_IDENTIFIER,
+  MACDRIVER_VERSION,
+  MACDRIVER_VERSION_PATTERN,
+  MACOS_MATCH_DIALECT,
+  NATIVE_ATTRIBUTE_MAP,
   SpawnMacHelperClient,
   UIA2_REMOTE_PORT,
   Uia2HttpError,
   Uia2Transport,
-  WDA_RUNNER_APP_NAME,
   WDA_RUNNER_BUNDLE_ID,
+  WDA_USE_PORT_ENV,
   WEB_ONLY_STEP_TYPES,
   WdaHttpError,
   WdaTransport,
+  analyzeAndroidApp,
+  analyzeIosApp,
   analyzeMacApp,
   analyzePage,
   androidAppAllowedIdentities,
+  androidNodeToNative,
   androidQueryToLocator,
   assertAndroidAppAllowed,
   assertIosAppAllowed,
@@ -134,6 +211,8 @@ export {
   closeIosSession,
   closeMacSession,
   clusterFailures,
+  codesignVerifier,
+  collectMacdriverStatus,
   computeFlakeScore,
   configSchema,
   createAndroidDriver,
@@ -143,8 +222,12 @@ export {
   createUia2Session,
   createWdaAgentClient,
   createWdaSession,
+  decodeXmlEntities,
   defaultAgentConnector,
   defaultIosAgentConnector,
+  defaultWdaTestRunPreparer,
+  dittoExtractor,
+  downloadAndVerify,
   escapePredicateArg,
   escapeUiSelectorArg,
   extractElementId,
@@ -154,9 +237,14 @@ export {
   generateHunt,
   healSelector,
   huntSchema,
+  injectUsePortIntoXctestrun,
+  installMacdriver,
   interpolateHunt,
   iosAppAllowedIdentities,
+  iosNodeToNative,
   iosQueryToLocator,
+  isAndroidInteractive,
+  isIosInteractive,
   launchAndroidSession,
   launchIosSession,
   launchMacSession,
@@ -167,18 +255,41 @@ export {
   loadHunt,
   loadHuntMeta,
   loadHuntTags,
+  macdriverAssetName,
+  macdriverAssetUrl,
   macdriverBuildInstructions,
+  macdriverChecksumName,
+  macdriverInstallRoot,
+  macdriverInstalledBinary,
+  macdriverReleaseTag,
+  macdriverVersionDir,
+  matchAndroidSelector,
+  matchIosSelector,
+  matchNativeTree,
+  nodeMatchesSelector,
   normalizeXcuiClassName,
   parseAaptPackage,
   parseAdbDevices,
+  parseAndroidHierarchy,
   parseAndroidSelector,
+  parseChecksumFile,
+  parseCodesignDetails,
   parseForwardPort,
+  parseIosHierarchy,
   parseIosSelector,
   parseMacSelector,
+  parseNativeSelector,
   parseSimctlDevices,
+  parseSnapshot,
   parseXcodeVersion,
+  parseXml,
+  qualifyResourceId,
+  quoteSelectorValue,
+  rankAndroidSelectors,
   rankFlaky,
+  rankIosSelectors,
   rankMacSelectors,
+  rankNativeSelectors,
   readHistory,
   readHuntHistory,
   readIosBundleIdentifier,
@@ -186,18 +297,29 @@ export {
   resolveAgentApks,
   resolveHelperBinary,
   resolveWdaProject,
-  resolveWdaRunner,
+  resolveWdaTestRun,
   runHunt,
   runSuite,
+  runVersionProbe,
   selectDeviceSerial,
   selectSimulatorUdid,
+  sha256Hex,
+  shortIosType,
   stepSchema,
+  tccGuidance,
+  unquoteSelectorValue,
   unwrapAndroidTextSelector,
   unwrapIosTextSelector,
+  unwrapNativeTextSelector,
   updateBacklogFromSuite,
+  validateMacdriverArchiveEntries,
+  validateMacdriverVersion,
+  verifyMacdriverSignature,
   waitForAgentReady,
   waitForWdaReady,
   wdaCacheDir,
-  webOnlyReason
+  wdaTestRunArgs,
+  webOnlyReason,
+  zipinfoArchiveLister
 };
 //# sourceMappingURL=lib.js.map

package/dist/{loader-FCXPARP7.js → loader-X37URHUV.js}

@@ -10,7 +10,7 @@ import {
   loadHuntTags,
   resolveViewport,
   warnLegacyConfigDir
-} from "./chunk-ITOSUJCN.js";
+} from "./chunk-O3OUTZ2P.js";
 export {
   CONFIG_DIR,
   LEGACY_CONFIG_DIR,
@@ -24,4 +24,4 @@ export {
   resolveViewport,
   warnLegacyConfigDir
 };
-//# sourceMappingURL=loader-FCXPARP7.js.map
+//# sourceMappingURL=loader-X37URHUV.js.map

package/examples/hunts/hello.yml

@@ -5,7 +5,7 @@
 #
 # Run it:  prowl run hello
 #
-# Browse more hunt templates at https://hub.prowl.tools
+# See .prowl/hunts/login-flow.yml for a fuller example (auth, secrets, assertions).
 
 name: hello
 description: Verify the target app loads successfully

package/examples/hunts/login-flow.yml

@@ -0,0 +1,58 @@
+# Login Flow
+# ---
+# Pattern: Authentication — email/password login with redirect verification
+# What it tests: Fill credentials, submit, verify redirect to dashboard.
+# Customize:
+#   - Update the selectors and URL paths to match your app's login page
+#   - Store credentials in .prowl/.env and reference them with {{VAR}}
+#
+# Tip: Use `prowl login` to capture auth state so other hunts can skip login.
+
+name: login-flow
+description: Log in with email and password, verify redirect to dashboard
+
+tags:
+  - auth
+  - login
+  - credentials
+
+# Store secrets in .prowl/.env — they'll be redacted in reports automatically.
+# Example .env:
+#   TEST_EMAIL=user@example.com
+#   TEST_PASSWORD=secret123
+vars:
+  EMAIL: "{{TEST_EMAIL}}"
+  PASSWORD: "{{TEST_PASSWORD}}"
+
+steps:
+  - navigate: "/login"
+
+  # Shorthand fill — Prowl finds the input by its label or placeholder text.
+  # Equivalent explicit form:
+  #   fill:
+  #     selector: "input[placeholder='Email']"
+  #     value: "{{EMAIL}}"
+  - fill:
+      "Email": "{{EMAIL}}"
+
+  - fill:
+      "Password": "{{PASSWORD}}"
+
+  # Shorthand click — Prowl finds a button by its text content.
+  # Equivalent explicit form:
+  #   click:
+  #     selector: "button:has-text('Sign In')"
+  - click: "Sign In"
+
+  # Wait for navigation to complete after login
+  - waitForUrl:
+      value: "/dashboard"
+      timeout: 10000
+
+  # Mid-flow assertion — verify the dashboard loaded
+  - assert:
+      visible: "Dashboard"
+
+assertions:
+  - urlIncludes: "/dashboard"
+  - noConsoleErrors: true

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prowl-tools",
-  "version": "0.1.5",
-  "description": "CLI-first QA testing tool for deterministic Playwright flows.",
+  "version": "0.1.7",
+  "description": "E2E testing for native macOS apps and web apps from declarative YAML hunts.",
   "type": "module",
   "license": "Apache-2.0",
   "author": "Prowl Tools",
@@ -16,9 +16,12 @@
   "keywords": [
     "testing",
     "qa",
+    "e2e",
+    "macos",
+    "desktop-testing",
+    "accessibility",
     "playwright",
     "yaml",
-    "e2e",
     "browser-testing",
     "automation",
     "web-testing",