@nac3/forge-cli 0.2.0-alpha.1

package/dist/codegen/e2e.d.ts

@@ -0,0 +1,106 @@
+export type Framework = 'playwright' | 'cypress' | 'vitest' | 'wdio';
+export declare const ALL_FRAMEWORKS: Framework[];
+export interface TestCase {
+    /** Stable id derived from manifest. */
+    id: string;
+    /** What the test asserts: one verb dispatch + outcome, or a flow. */
+    kind: 'action_dispatch' | 'field_read' | 'field_write' | 'tab_switch' | 'region_present';
+    /** Human-readable name. */
+    name: string;
+    /** Plugin slug. */
+    plugin: string;
+    /** Target element's data-nac-id. */
+    nac_id: string;
+    /** Verb (only for action_dispatch). */
+    verb?: string;
+    /** Optional sample input for fields. */
+    sample_input?: string;
+    /** H1: route to navigate to before dispatch. Defaults to "/" when
+       unknown or "*" (always-mounted). When present, the emitter wraps
+       the test with cy.visit(route) BEFORE the NAC call. */
+    visit_route?: string;
+    /** H1: when true, the emitter inserts cy.login() before cy.visit(). */
+    requires_auth?: boolean;
+    /** H1.v3: the URL params that need fixture seeding before the test
+       can run. Derived from visit_route's :param tokens cross-referenced
+       against the manifest.fixtures map. */
+    fixture_params?: string[];
+    /** H1.v6: when the manifest entry is a template (instance_pattern),
+       the runtime needs an explicit qualifier so it resolves to the
+       right qualified DOM instance instead of matching on first-verb
+       wins. The qualifier alias names the fixture variable the it()
+       body resolves (e.g. "slug" maps to the article slug created in
+       beforeEach). Emitter passes `{ qualifier: <alias> }` to
+       NAC.click_by_verb / NAC.fill / NAC.tab. */
+    qualifier_alias?: string;
+    /** H1.v6 item 4 -- multi-user fixture: when a verb requires
+       viewer != author (follow_author / unfollow / favorite_article),
+       the fixture must be created by a SECONDARY user so the test
+       user can interact with it. "primary" (default) uses the test
+       user for both create and view; "secondary_author" creates the
+       fixture with a second user, then logs back in as the test user
+       before the it() body. */
+    viewer_role?: 'primary' | 'secondary_author';
+}
+export interface FixtureSpec {
+    create_endpoint: string;
+    create_payload: any;
+    response_path: string;
+    delete_endpoint?: string | null;
+    requires_auth?: boolean;
+    unique_suffix_field?: string | null;
+}
+export interface TestPlan {
+    plugin: string;
+    manifest_path: string;
+    /** URL the test should navigate to. Caller resolves this from
+       the framework's project config (Playwright baseURL, Cypress
+       baseUrl, etc). For the first cut we leave it as a placeholder
+       the consumer fills in their config. */
+    page_url_token: string;
+    cases: TestCase[];
+    /** Surface coverage: how many manifest elements we exercise. */
+    total_elements: number;
+    exercised_elements: number;
+    /** H1.v3: fixtures the emitter wires into beforeEach / afterEach
+       for tests whose visit_route contains :params. */
+    fixtures?: Record<string, FixtureSpec>;
+    /** H1.v4: Router kind. When "hash", the emitter prefixes visit
+       URLs with "#" so cy.visit hits the right SPA route. */
+    router_kind?: 'browser' | 'hash' | 'memory';
+}
+export declare function planFromManifest(manifest: any, options?: {
+    pageUrlToken?: string;
+}): TestPlan;
+export declare function detectFramework(targetDir: string): Promise<Framework | null>;
+interface EmittedFile {
+    relpath: string;
+    content: string;
+}
+export interface EmitOptions {
+    /** Where the agent-driven app is served. Each framework
+       interpolates this into its base config. */
+    baseUrl?: string;
+}
+export declare function emitPlaywright(plan: TestPlan, opts?: EmitOptions): EmittedFile[];
+export declare function emitCypress(plan: TestPlan, opts?: EmitOptions): EmittedFile[];
+export declare function emitVitest(plan: TestPlan, opts?: EmitOptions): EmittedFile[];
+export declare function emitWdio(plan: TestPlan, opts?: EmitOptions): EmittedFile[];
+export interface GenerateOptions {
+    outDir: string;
+    framework: Framework | Framework[];
+    baseUrl?: string;
+    /** When true, overwrite existing files. Default false (skip). */
+    overwrite?: boolean;
+}
+export interface GenerateResult {
+    framework: Framework;
+    filesWritten: string[];
+    filesSkipped: string[];
+    cases: number;
+    exercised_elements: number;
+    total_elements: number;
+}
+export declare function generateTests(plan: TestPlan, opts: GenerateOptions): Promise<GenerateResult[]>;
+export {};
+//# sourceMappingURL=e2e.d.ts.map

package/dist/codegen/e2e.d.ts.map

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