@fluentui-react-native/desktop-driver 0.2.0

package/lib/agent/agent.contract.cjs

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+const path = require('node:path');
+const { pathToFileURL } = require('node:url');
+async function main() {
+    const moduleUrl = pathToFileURL(path.resolve(__dirname, '..', '..', 'lib', 'agent', 'index.js')).href;
+    const { connectDesktopAgent } = await Promise.resolve(`${moduleUrl}`).then(s => __importStar(require(s)));
+    const [url, targetId, artifactsRoot] = process.argv.slice(2);
+    const agent = await connectDesktopAgent({
+        artifactsRoot,
+        platformName: 'windows',
+        targetId,
+        url,
+    });
+    try {
+        const stories = await agent.listStories();
+        const story = await agent.explainStory('components-button--default');
+        await agent.openStory(story.id);
+        const tree = await agent.describe({ depth: 2, maxNodes: 10, scope: 'story' });
+        await agent.click({ testId: 'button-primary' });
+        const check = await agent.check({ state: 'focused', target: { testId: 'button-primary' }, value: true });
+        const screenshot = await agent.screenshot('agent-button');
+        const run = await agent.runStoryTest(story.id, 'agent-plan');
+        process.stdout.write(JSON.stringify({ check, run, screenshot, stories: stories.length, tree: tree.length }));
+    }
+    finally {
+        await agent.delete();
+    }
+}
+main().catch((error) => {
+    process.stderr.write(error.stack ?? error.message);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=agent.contract.cjs.map

package/lib/agent/agent.contract.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.contract.cjs","sourceRoot":"","sources":["../../src/agent/agent.contract.cjs"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAClC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE9C,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACtG,MAAM,EAAE,mBAAmB,EAAE,GAAG,yBAAa,SAAS,uCAAC,CAAC;IACxD,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC;QACtC,aAAa;QACb,YAAY,EAAE,SAAS;QACvB,QAAQ;QACR,GAAG;KACJ,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC;QACrE,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9E,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzG,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/G,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/lib/agent/agent.contract.d.cts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent.contract.d.cts.map

package/lib/agent/agent.contract.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.contract.d.cts","sourceRoot":"","sources":["../../src/agent/agent.contract.cjs"],"names":[],"mappings":""}

package/lib/agent/index.d.ts

@@ -0,0 +1,3 @@
+export { connectDesktopAgent, DesktopAgent } from './DesktopAgent.js';
+export type { DesktopAgentCheckResult, DesktopAgentDescribeOptions, DesktopAgentElement, DesktopAgentOptions, DesktopAgentStory, } from './DesktopAgent.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/lib/agent/index.js

@@ -0,0 +1,2 @@
+export { connectDesktopAgent, DesktopAgent } from './DesktopAgent.js';
+//# sourceMappingURL=index.js.map

package/lib/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/artifacts/ArtifactManager.d.ts

@@ -0,0 +1,13 @@
+import type { DesktopArtifact, DesktopStoryRunResult } from '../authoring/results.js';
+export declare class ArtifactManager {
+    readonly root: string;
+    constructor(root: string);
+    writeScreenshot(testDirectory: string, name: string, base64: string): DesktopArtifact;
+    writeSource(testDirectory: string, name: string, source: string): DesktopArtifact;
+    writeTree(testDirectory: string, name: string, tree: unknown): DesktopArtifact;
+    writeRunResult(result: DesktopStoryRunResult): string;
+    writeMetadata(name: string, value: unknown): string;
+    private write;
+    private resolvePath;
+}
+//# sourceMappingURL=ArtifactManager.d.ts.map

package/lib/artifacts/ArtifactManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactManager.d.ts","sourceRoot":"","sources":["../../src/artifacts/ArtifactManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEtF,qBAAa,eAAe;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAMvB;IAED,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAEpF;IAED,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAEhF;IAED,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,CAE7E;IAED,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAIpD;IAED,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAIlD;IAED,OAAO,CAAC,KAAK;IAmBb,OAAO,CAAC,WAAW;CAkBpB"}

package/lib/artifacts/ArtifactManager.js

@@ -0,0 +1,88 @@
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+export class ArtifactManager {
+    root;
+    constructor(root) {
+        if (!root) {
+            throw new TypeError('ArtifactManager requires a non-empty root path.');
+        }
+        fs.mkdirSync(root, { recursive: true });
+        this.root = fs.realpathSync.native(root);
+    }
+    writeScreenshot(testDirectory, name, base64) {
+        return this.write(testDirectory, name, 'png', Buffer.from(base64, 'base64'), 'screenshot');
+    }
+    writeSource(testDirectory, name, source) {
+        return this.write(testDirectory, name, 'xml', source, 'source');
+    }
+    writeTree(testDirectory, name, tree) {
+        return this.write(testDirectory, name, 'json', `${JSON.stringify(tree, null, 2)}\n`, 'tree');
+    }
+    writeRunResult(result) {
+        const outputPath = this.resolvePath('run.json');
+        writeAtomic(outputPath, `${JSON.stringify(result, null, 2)}\n`);
+        return outputPath;
+    }
+    writeMetadata(name, value) {
+        const outputPath = this.resolvePath(`${sanitizeSegment(name)}.json`);
+        writeAtomic(outputPath, `${JSON.stringify(value, null, 2)}\n`);
+        return outputPath;
+    }
+    write(testDirectory, name, extension, data, kind) {
+        const safeDirectory = sanitizeSegment(testDirectory);
+        const safeName = sanitizeSegment(name);
+        const relativePath = path.join('tests', safeDirectory, `${safeName}.${extension}`);
+        const outputPath = this.resolvePath(relativePath);
+        writeAtomic(outputPath, data);
+        return {
+            kind,
+            name,
+            path: relativePath.split(path.sep).join('/'),
+        };
+    }
+    resolvePath(relativePath) {
+        if (path.isAbsolute(relativePath)) {
+            throw new Error('Artifact paths must be relative to the configured root.');
+        }
+        const outputPath = path.resolve(this.root, relativePath);
+        const relative = path.relative(this.root, outputPath);
+        if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+            throw new Error(`Artifact path escapes the configured root: ${relativePath}`);
+        }
+        const parent = path.dirname(outputPath);
+        fs.mkdirSync(parent, { recursive: true });
+        const realParent = fs.realpathSync.native(parent);
+        const realRelative = path.relative(this.root, realParent);
+        if (realRelative === '..' || realRelative.startsWith(`..${path.sep}`) || path.isAbsolute(realRelative)) {
+            throw new Error(`Artifact path traverses outside the configured root: ${relativePath}`);
+        }
+        return path.join(realParent, path.basename(outputPath));
+    }
+}
+function sanitizeSegment(value) {
+    let sanitized = value
+        .replaceAll(/[^A-Za-z0-9._-]/g, '-')
+        .replaceAll(/-+/g, '-')
+        .replace(/^\.+/, '');
+    if (/^(?:aux|con|nul|prn|com[1-9]|lpt[1-9])(?:\.|$)/i.test(sanitized)) {
+        sanitized = `_${sanitized}`;
+    }
+    if (!sanitized || sanitized === '.' || sanitized === '..') {
+        throw new Error(`Invalid artifact name "${value}".`);
+    }
+    return sanitized;
+}
+function writeAtomic(outputPath, data) {
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    const temporaryPath = `${outputPath}.${randomUUID()}.tmp`;
+    try {
+        fs.writeFileSync(temporaryPath, data);
+        fs.renameSync(temporaryPath, outputPath);
+    }
+    catch (error) {
+        fs.rmSync(temporaryPath, { force: true });
+        throw error;
+    }
+}
+//# sourceMappingURL=ArtifactManager.js.map

package/lib/artifacts/ArtifactManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactManager.js","sourceRoot":"","sources":["../../src/artifacts/ArtifactManager.ts"],"names":[],"mappings":"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"}

package/lib/artifacts/ArtifactManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ArtifactManager.test.d.ts.map

package/lib/artifacts/ArtifactManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactManager.test.d.ts","sourceRoot":"","sources":["../../src/artifacts/ArtifactManager.test.ts"],"names":[],"mappings":""}

package/lib/artifacts/ArtifactManager.test.js

@@ -0,0 +1,19 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { ArtifactManager } from './ArtifactManager.js';
+describe('ArtifactManager', () => {
+    test('confines and atomically writes artifacts beneath the run root', () => {
+        const temporaryDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'desktop-driver-artifacts-'));
+        try {
+            const manager = new ArtifactManager(temporaryDirectory);
+            const artifact = manager.writeSource('../story:id', '../source', '<application />');
+            expect(artifact.path).toBe('tests/-story-id/-source.xml');
+            expect(fs.readFileSync(path.join(temporaryDirectory, ...artifact.path.split('/')), 'utf8')).toBe('<application />');
+        }
+        finally {
+            fs.rmSync(temporaryDirectory, { force: true, recursive: true });
+        }
+    });
+});
+//# sourceMappingURL=ArtifactManager.test.js.map

package/lib/artifacts/ArtifactManager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArtifactManager.test.js","sourceRoot":"","sources":["../../src/artifacts/ArtifactManager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACzE,MAAM,kBAAkB,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;QAC/F,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,kBAAkB,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;YAEpF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YAC1D,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtH,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/artifacts/index.d.ts

@@ -0,0 +1,2 @@
+export { ArtifactManager } from './ArtifactManager.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/artifacts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/artifacts/index.js

@@ -0,0 +1,2 @@
+export { ArtifactManager } from './ArtifactManager.js';
+//# sourceMappingURL=index.js.map

package/lib/artifacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/authoring/index.d.ts

@@ -0,0 +1,4 @@
+export type { DesktopArtifact, DesktopRunStatus, DesktopStepStatus, DesktopStoryRunResult, DesktopStoryStepResult, DesktopStoryTestResult, DesktopTestStatus, } from './results.js';
+export { defineDesktopStoryTests, desktopBy, desktopStoryCapabilities, desktopStoryPlatforms, validateDesktopStoryTests, } from './storyTests.js';
+export type { DesktopStoryCapability, DesktopStoryExpectation, DesktopStoryPlatform, DesktopStorySelector, DesktopStoryState, DesktopStoryStep, DesktopStoryTest, DesktopStoryTests, } from './storyTests.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/authoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/lib/authoring/index.js

@@ -0,0 +1,2 @@
+export { defineDesktopStoryTests, desktopBy, desktopStoryCapabilities, desktopStoryPlatforms, validateDesktopStoryTests, } from './storyTests.js';
+//# sourceMappingURL=index.js.map

package/lib/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AASA,OAAO,EACL,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/lib/authoring/results.d.ts

@@ -0,0 +1,43 @@
+import type { DesktopEndpoint, DesktopPlatformName } from '../protocol/types.js';
+export type DesktopArtifact = {
+    kind: 'screenshot' | 'source' | 'tree';
+    name: string;
+    path: string;
+};
+export type DesktopStepStatus = 'failed' | 'passed' | 'skipped';
+export type DesktopTestStatus = 'cancelled' | 'failed' | 'infrastructure-error' | 'passed' | 'skipped' | 'timed-out';
+export type DesktopRunStatus = 'failed' | 'passed';
+export type DesktopStoryStepResult = {
+    artifacts: readonly DesktopArtifact[];
+    durationMs: number;
+    error?: string;
+    index: number;
+    status: DesktopStepStatus;
+};
+export type DesktopStoryTestResult = {
+    artifacts: readonly DesktopArtifact[];
+    durationMs: number;
+    error?: string;
+    skipReason?: string;
+    status: DesktopTestStatus;
+    steps: readonly DesktopStoryStepResult[];
+    storyId: string;
+    testId: string;
+    title: string;
+};
+export type DesktopStoryRunResult = {
+    endpoint: DesktopEndpoint;
+    finishedAt: string;
+    manifest: {
+        platform: string;
+        portable: string;
+    };
+    platformName: DesktopPlatformName;
+    runId: string;
+    schemaVersion: 1;
+    startedAt: string;
+    status: DesktopRunStatus;
+    targetId: string;
+    tests: readonly DesktopStoryTestResult[];
+};
+//# sourceMappingURL=results.d.ts.map

package/lib/authoring/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/authoring/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,sBAAsB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AACrH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnD,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,mBAAmB,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC1C,CAAC"}

package/lib/authoring/results.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=results.js.map

package/lib/authoring/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/authoring/results.ts"],"names":[],"mappings":""}

package/lib/authoring/storyTests.d.ts

@@ -0,0 +1,81 @@
+import type { WebDriverActionSequence } from '../protocol/types.js';
+export declare const desktopStoryPlatforms: readonly ['macos', 'windows', 'win32'];
+export declare const desktopStoryCapabilities: readonly ['accessibility-click', 'element-screenshot', 'focus', 'keyboard', 'physical-click', 'screenshot', 'wheel'];
+export type DesktopStoryPlatform = (typeof desktopStoryPlatforms)[number];
+export type DesktopStoryCapability = (typeof desktopStoryCapabilities)[number];
+export type DesktopStorySelector = {
+    testId: string;
+} | {
+    role: string;
+    name?: string;
+} | {
+    accessibleName: string;
+} | {
+    text: string;
+};
+export type DesktopStoryState = 'accessibleName' | 'checked' | 'count' | 'displayed' | 'enabled' | 'expanded' | 'exists' | 'focused' | 'role' | 'selected' | 'text' | 'value';
+export type DesktopStoryExpectation = {
+    state: DesktopStoryState;
+    target: DesktopStorySelector;
+    value?: boolean | number | string;
+};
+export type DesktopStoryStep = {
+    action: 'actions';
+    sequences: readonly WebDriverActionSequence[];
+} | {
+    action: 'clear' | 'click' | 'doubleClick';
+    target: DesktopStorySelector;
+} | {
+    action: 'keys';
+    value: readonly string[];
+} | {
+    action: 'note';
+    message: string;
+} | {
+    action: 'screenshot';
+    name: string;
+    target?: DesktopStorySelector;
+} | {
+    action: 'scroll';
+    deltaX?: number;
+    deltaY: number;
+    target?: DesktopStorySelector;
+} | {
+    action: 'setArgs';
+    args: Readonly<Record<string, unknown>>;
+} | {
+    action: 'source';
+    name: string;
+} | {
+    action: 'type';
+    target: DesktopStorySelector;
+    text: string;
+} | {
+    action: 'wait';
+    target?: DesktopStorySelector;
+    timeoutMs?: number;
+    until?: DesktopStoryExpectation;
+} | {
+    expect: DesktopStoryExpectation;
+};
+export type DesktopStoryTest = {
+    id: string;
+    platforms?: readonly DesktopStoryPlatform[];
+    requires?: readonly DesktopStoryCapability[];
+    steps: readonly DesktopStoryStep[];
+    title?: string;
+};
+export type DesktopStoryTests = {
+    portable?: boolean;
+    tests: readonly DesktopStoryTest[];
+    version: 1;
+};
+export declare const desktopBy: {
+    accessibleName: (accessibleName: string) => DesktopStorySelector;
+    role: (role: string, name?: string) => DesktopStorySelector;
+    testId: (testId: string) => DesktopStorySelector;
+    text: (text: string) => DesktopStorySelector;
+};
+export declare function defineDesktopStoryTests(plan: DesktopStoryTests): DesktopStoryTests;
+export declare function validateDesktopStoryTests(value: unknown, source?: string): DesktopStoryTests;
+//# sourceMappingURL=storyTests.d.ts.map

package/lib/authoring/storyTests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyTests.d.ts","sourceRoot":"","sources":["../../src/authoring/storyTests.ts"],"names":[],"mappings":"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"}