@ascendenceai/cortena-extensions-e2e-kit 0.1.0

package/dist/fixtures/shell.js

@@ -0,0 +1,96 @@
+import { expect } from '@playwright/test';
+import { SHELL } from '../locators.js';
+export function shell(page) {
+    const avatarTrigger = page.locator(SHELL.avatarTrigger);
+    const helpButton = page.locator(SHELL.helpButton);
+    const helpPanel = page.locator(SHELL.helpPanel);
+    const navDrawer = page.locator(SHELL.navDrawer);
+    const navToggle = page.locator(SHELL.navToggle);
+    return {
+        root: page.locator(SHELL.root),
+        header: page.locator(SHELL.header),
+        brand: page.locator(SHELL.brand),
+        brandName: page.locator(SHELL.brandName),
+        brandSquare: page.locator(SHELL.brandSquare),
+        brandMark: page.locator(SHELL.brandMark).first(),
+        nav: page.locator(SHELL.nav),
+        navItems: page.locator(SHELL.navItem),
+        navItem: (label) => page.locator(SHELL.navItem).filter({ hasText: label }),
+        navItemById: (id) => page.locator(SHELL.navItemById(id)),
+        currentNavItem: page.locator(SHELL.navItemCurrent),
+        navToggle,
+        navDrawer,
+        navDrawerClose: page.locator(SHELL.navDrawerClose),
+        main: page.locator(SHELL.main),
+        avatarTrigger,
+        menuItem: (id) => page.locator(SHELL.menuItem(id)),
+        cluster: page.locator(SHELL.cluster),
+        themeToggle: page.locator(SHELL.themeToggle),
+        helpButton,
+        helpPanel,
+        async openAvatarMenu() {
+            await avatarTrigger.click();
+            await expect(page.locator(SHELL.menuItem('logout'))).toBeVisible();
+        },
+        async openHelp() {
+            await helpButton.click();
+            await expect(helpPanel).toBeVisible();
+        },
+        /**
+         * The viewport stays narrow afterwards. Deliberate: the drawer is the last
+         * thing the shell spec asserts, and a helper that silently restored it
+         * would make a following assertion pass at a width the caller did not
+         * choose. Set it back explicitly if more follows.
+         */
+        async openNavDrawer() {
+            /*
+             * The drawer is not a second navigation: it is the same nav, below the
+             * shell's breakpoint. The viewport is narrowed here rather than in a
+             * third Playwright project, because two projects are already both themes
+             * and a third dimension would be eight runs of the six specs for one
+             * assertion about a focus trap.
+             */
+            await page.setViewportSize({ width: 480, height: 900 });
+            await expect(navToggle).toBeVisible();
+            await navToggle.click();
+            await expect(navDrawer).toBeVisible();
+        },
+    };
+}
+/**
+ * §10 / P-10, in one call: the mark and the name top-left, the destinations in
+ * the sidebar, **Settings under the avatar and nowhere else**, and the theme
+ * and help controls in the bottom-right cluster.
+ *
+ * The "and nowhere else" half is the one that decays. An extension adds a
+ * settings link to its sidebar because it is convenient, and the fleet stops
+ * having one place settings lives; asserting the absence is the only way that
+ * gets noticed.
+ */
+export async function expectShellChrome(page, expectations) {
+    const s = shell(page);
+    await expect(s.root).toBeVisible();
+    await expect(s.brand).toBeVisible();
+    await expect(s.brandName).toHaveText(expectations.brandName);
+    await expect(s.brandSquare).toBeVisible();
+    for (const label of expectations.navItems) {
+        await expect(s.navItem(label).first()).toBeVisible();
+    }
+    // Settings is not a destination in the sidebar (§10.2, mockup decision B1).
+    await expect(s.nav.getByText(/^settings$/i)).toHaveCount(0);
+    await s.openAvatarMenu();
+    await expect(s.menuItem('settings')).toBeVisible();
+    await expect(s.menuItem('logout')).toBeVisible();
+    for (const id of expectations.menuItems ?? []) {
+        await expect(s.menuItem(id)).toBeVisible();
+    }
+    await page.keyboard.press('Escape');
+    // Theme then help, in that order, in the one cluster (§9.3).
+    await expect(s.cluster).toBeVisible();
+    await expect(s.themeToggle).toBeVisible();
+    await expect(s.helpButton).toBeVisible();
+    await s.openHelp();
+    await expect(s.helpPanel).toBeVisible();
+    await page.keyboard.press('Escape');
+}
+//# sourceMappingURL=shell.js.map

package/dist/fixtures/shell.js.map

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

package/dist/fixtures/sign-in.d.ts

@@ -0,0 +1,59 @@
+import { type Locator, type Page } from '@playwright/test';
+import { type E2ECredentials } from '../env.js';
+export interface SignInOptions {
+    /** Where to land. Defaults to `/`. */
+    route?: string;
+    /** Overrides the environment, for a spec that needs a second identity. */
+    credentials?: E2ECredentials;
+    /**
+     * Ignore `CORTENA_E2E_TOKEN` and drive the form. The login-page spec needs
+     * this: a token handoff proves the store reads the URL, not that anybody can
+     * actually sign in.
+     */
+    useForm?: boolean;
+}
+/**
+ * Signs in against the test cortena-auth and lands on `route`.
+ *
+ * Two ways in, and the difference matters:
+ *
+ *   - **A token.** `CORTENA_E2E_TOKEN` goes on the URL, which is what the app's
+ *     auth store reads synchronously in `getInitialState()` before the first
+ *     render (§7.3). It is the fast path and the one every spec that is not
+ *     about signing in should take — a suite that types a password six times
+ *     is a suite that fails six times when the password rotates.
+ *   - **The form.** The organisation step, then the credentials step. This is
+ *     the only thing that proves a person can get in, so the login spec uses
+ *     it even when a token is available.
+ *
+ * The form is found through `SIGN_IN` and nowhere else: DESIGN-119 changes how
+ * the sign-in screen is mounted, and when it does this function keeps working
+ * because the shared `data-slot`s are tried first.
+ */
+export declare function signIn(page: Page, options?: SignInOptions): Promise<void>;
+/**
+ * The organisation step, which decides *how* the org signs in before it asks
+ * for anything: password, Google, or both (P-08). An extension that has no
+ * such step — one org, or the org on the URL — simply has no such field, and
+ * this returns without failing.
+ */
+export declare function organisationStep(page: Page, orgId: string): Promise<boolean>;
+/**
+ * Anything that means "this is the sign-in screen": the shared composition, or
+ * the extension's own organisation or password field.
+ */
+export declare function signInScreen(page: Page): Locator;
+/**
+ * Whether a sign-in screen is on the page.
+ *
+ * It **waits**, and the timeout is the whole design. Asked right after a
+ * navigation the answer is always "no": a single-page app answers `goto` with
+ * an empty document and renders afterwards. So the positive case gets a real
+ * timeout, and a caller asserting the *absence* of a sign-in screen passes a
+ * short one — having already waited for something that proves the app rendered.
+ */
+export declare function isSignInScreen(page: Page, options?: {
+    timeout?: number;
+}): Promise<boolean>;
+/** `?token=…`, preserving whatever query the route already carried. */
+export declare function withToken(route: string, token: string, refreshToken?: string): string;

package/dist/fixtures/sign-in.js

@@ -0,0 +1,115 @@
+import { expect } from '@playwright/test';
+import { SIGN_IN } from '../locators.js';
+import { readCredentials } from '../env.js';
+/**
+ * Signs in against the test cortena-auth and lands on `route`.
+ *
+ * Two ways in, and the difference matters:
+ *
+ *   - **A token.** `CORTENA_E2E_TOKEN` goes on the URL, which is what the app's
+ *     auth store reads synchronously in `getInitialState()` before the first
+ *     render (§7.3). It is the fast path and the one every spec that is not
+ *     about signing in should take — a suite that types a password six times
+ *     is a suite that fails six times when the password rotates.
+ *   - **The form.** The organisation step, then the credentials step. This is
+ *     the only thing that proves a person can get in, so the login spec uses
+ *     it even when a token is available.
+ *
+ * The form is found through `SIGN_IN` and nowhere else: DESIGN-119 changes how
+ * the sign-in screen is mounted, and when it does this function keeps working
+ * because the shared `data-slot`s are tried first.
+ */
+export async function signIn(page, options = {}) {
+    const credentials = options.credentials ?? readCredentials();
+    const route = options.route ?? '/';
+    if (credentials.token && !options.useForm) {
+        await page.goto(withToken(route, credentials.token));
+        return;
+    }
+    if (!credentials.email || !credentials.password) {
+        throw new Error('signIn({ useForm: true }) needs CORTENA_E2E_USER_EMAIL and CORTENA_E2E_USER_PASSWORD. '
+            + 'A token proves the URL handoff works; only the form proves a person can sign in.');
+    }
+    await page.goto(route);
+    await organisationStep(page, credentials.orgId);
+    await credentialsStep(page, credentials.email, credentials.password);
+}
+/**
+ * The organisation step, which decides *how* the org signs in before it asks
+ * for anything: password, Google, or both (P-08). An extension that has no
+ * such step — one org, or the org on the URL — simply has no such field, and
+ * this returns without failing.
+ */
+export async function organisationStep(page, orgId) {
+    /*
+     * Waited for, not counted. A single-page app answers `goto` with an empty
+     * document and renders afterwards, so a `count()` taken the instant the
+     * navigation resolves is a count of nothing — which reads as "this extension
+     * has no organisation step" and then fails four assertions later on
+     * something unrelated.
+     */
+    if (!(await isSignInScreen(page))) {
+        throw new Error('organisationStep: no sign-in screen appeared. Either the app did not render, or it is '
+            + 'already signed in.');
+    }
+    const field = page.getByLabel(SIGN_IN.own.orgLabel);
+    if (!(await field.isVisible().catch(() => false)))
+        return false;
+    await field.fill(orgId);
+    await page.getByRole('button', { name: SIGN_IN.own.orgSubmit }).click();
+    return true;
+}
+async function credentialsStep(page, email, password) {
+    const emailField = page.getByLabel(SIGN_IN.own.emailLabel);
+    await emailField.waitFor({ state: 'visible' });
+    await emailField.fill(email);
+    await page.getByLabel(SIGN_IN.own.passwordLabel).fill(password);
+    const shared = page.locator(SIGN_IN.shared.submit);
+    if (await shared.isVisible().catch(() => false))
+        await shared.click();
+    else
+        await page.getByRole('button', { name: SIGN_IN.own.submit }).click();
+    /*
+     * Signed in is the *absence* of the form, not the presence of a heading: the
+     * heading is the extension's and the kit does not know it. An error banner is
+     * asserted against separately so a wrong password reports itself rather than
+     * timing out on something invisible.
+     */
+    await expect(page.locator(SIGN_IN.shared.error)).toHaveCount(0);
+    await expect(page.getByLabel(SIGN_IN.own.passwordLabel)).toHaveCount(0, { timeout: 30_000 });
+}
+/**
+ * Anything that means "this is the sign-in screen": the shared composition, or
+ * the extension's own organisation or password field.
+ */
+export function signInScreen(page) {
+    return page
+        .locator(SIGN_IN.shared.screen)
+        .or(page.locator(SIGN_IN.shared.form))
+        .or(page.getByLabel(SIGN_IN.own.orgLabel))
+        .or(page.getByLabel(SIGN_IN.own.passwordLabel));
+}
+/**
+ * Whether a sign-in screen is on the page.
+ *
+ * It **waits**, and the timeout is the whole design. Asked right after a
+ * navigation the answer is always "no": a single-page app answers `goto` with
+ * an empty document and renders afterwards. So the positive case gets a real
+ * timeout, and a caller asserting the *absence* of a sign-in screen passes a
+ * short one — having already waited for something that proves the app rendered.
+ */
+export async function isSignInScreen(page, options = {}) {
+    try {
+        await signInScreen(page).first().waitFor({ state: 'visible', timeout: options.timeout ?? 15_000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** `?token=…`, preserving whatever query the route already carried. */
+export function withToken(route, token, refreshToken = 'none') {
+    const separator = route.includes('?') ? '&' : '?';
+    return `${route}${separator}token=${encodeURIComponent(token)}&refreshToken=${encodeURIComponent(refreshToken)}`;
+}
+//# sourceMappingURL=sign-in.js.map

package/dist/fixtures/sign-in.js.map

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

package/dist/fixtures/theme.d.ts

@@ -0,0 +1,42 @@
+import { type Page } from '@playwright/test';
+export type ThemeMode = 'light' | 'dark';
+/**
+ * `attribute` — the user chose, so `data-theme` is written on `<html>`.
+ * `os`        — the user did not, so there is no attribute and the painted
+ *               theme comes from `prefers-color-scheme`.
+ */
+export type ThemePath = 'attribute' | 'os';
+/**
+ * Puts the page in a theme, and asserts it got there.
+ *
+ * cortena-design drives dark mode off `data-theme` on `<html>` and falls back
+ * to `prefers-color-scheme` when the attribute is **absent**. Those are two
+ * different code paths and a suite that only ever writes the attribute never
+ * exercises the one a first-time visitor takes — which is how a fleet ends up
+ * with an extension that is correct in dark mode only for people who once
+ * pressed the toggle.
+ *
+ * So `theme()` does both:
+ *
+ *   theme(page, 'dark')                  // the stored choice, data-theme="dark"
+ *   theme(page, 'dark', { path: 'os' })  // nothing stored, OS says dark
+ *
+ * Call it **before** the first navigation: the choice is read out of
+ * localStorage before the first paint, so writing it afterwards proves only
+ * that a re-render happens.
+ */
+export declare function theme(page: Page, mode: ThemeMode, options?: {
+    path?: ThemePath;
+    storageKey?: string;
+}): Promise<void>;
+/**
+ * What is actually painted, and how it got there.
+ *
+ * On the attribute path `<html data-theme>` says the mode outright. On the OS
+ * path the attribute is absent by design, so the evidence is the toggle's
+ * `data-theme-resolved` — which is `useCortenaTheme`'s own answer to "what am
+ * I painting", published for exactly this.
+ */
+export declare function expectTheme(page: Page, mode: ThemeMode, path?: ThemePath): Promise<void>;
+/** The mode the project name encodes — `chromium-dark-1280` is the dark project. */
+export declare function themeFromProjectName(name: string): ThemeMode;

package/dist/fixtures/theme.js

@@ -0,0 +1,79 @@
+import { expect } from '@playwright/test';
+import { SHELL, THEME } from '../locators.js';
+/**
+ * Puts the page in a theme, and asserts it got there.
+ *
+ * cortena-design drives dark mode off `data-theme` on `<html>` and falls back
+ * to `prefers-color-scheme` when the attribute is **absent**. Those are two
+ * different code paths and a suite that only ever writes the attribute never
+ * exercises the one a first-time visitor takes — which is how a fleet ends up
+ * with an extension that is correct in dark mode only for people who once
+ * pressed the toggle.
+ *
+ * So `theme()` does both:
+ *
+ *   theme(page, 'dark')                  // the stored choice, data-theme="dark"
+ *   theme(page, 'dark', { path: 'os' })  // nothing stored, OS says dark
+ *
+ * Call it **before** the first navigation: the choice is read out of
+ * localStorage before the first paint, so writing it afterwards proves only
+ * that a re-render happens.
+ */
+export async function theme(page, mode, options = {}) {
+    const path = options.path ?? 'attribute';
+    const storageKey = options.storageKey ?? THEME.storageKey;
+    if (path === 'os') {
+        /*
+         * "The OS says dark" means the *stored choice is absent*. Leaving a
+         * previous spec's choice behind would make this assert the attribute path
+         * a second time under a different name.
+         */
+        await page.addInitScript((key) => {
+            try {
+                window.localStorage.removeItem(key);
+            }
+            catch { /* a blocked store is still no choice */ }
+        }, storageKey);
+        await page.emulateMedia({ colorScheme: mode });
+        return;
+    }
+    await page.addInitScript(([key, value]) => {
+        try {
+            window.localStorage.setItem(key, value);
+        }
+        catch { /* see above */ }
+    }, [storageKey, mode]);
+    /*
+     * The OS is set to the *opposite*. If the attribute path silently stopped
+     * working, a page whose OS agreed with the stored choice would still look
+     * right and the assertion below would pass for the wrong reason.
+     */
+    await page.emulateMedia({ colorScheme: mode === 'dark' ? 'light' : 'dark' });
+}
+/**
+ * What is actually painted, and how it got there.
+ *
+ * On the attribute path `<html data-theme>` says the mode outright. On the OS
+ * path the attribute is absent by design, so the evidence is the toggle's
+ * `data-theme-resolved` — which is `useCortenaTheme`'s own answer to "what am
+ * I painting", published for exactly this.
+ */
+export async function expectTheme(page, mode, path = 'attribute') {
+    const html = page.locator('html');
+    if (path === 'attribute') {
+        await expect(html).toHaveAttribute(THEME.attribute, mode);
+    }
+    else {
+        await expect(html).not.toHaveAttribute(THEME.attribute, /light|dark/);
+    }
+    const toggle = page.locator(SHELL.themeToggle);
+    if ((await toggle.count()) > 0) {
+        await expect(toggle.first()).toHaveAttribute(THEME.resolvedAttribute, mode);
+        await expect(toggle.first()).toHaveAttribute(THEME.choiceAttribute, path === 'attribute' ? mode : 'system');
+    }
+}
+/** The mode the project name encodes — `chromium-dark-1280` is the dark project. */
+export function themeFromProjectName(name) {
+    return /dark/i.test(name) ? 'dark' : 'light';
+}
+//# sourceMappingURL=theme.js.map

package/dist/fixtures/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/fixtures/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAa,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAU9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAU,EACV,IAAe,EACf,UAAqD,EAAE;IAEvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;IAE1D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB;;;;WAIG;QACH,MAAM,IAAI,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,IAAI,CAAC;gBAAC,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,wCAAwC,CAAC,CAAC;QACjG,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,MAAM,IAAI,CAAC,aAAa,CACtB,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACf,IAAI,CAAC;YAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAa,EAAE,KAAe,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;IAChG,CAAC,EACD,CAAC,UAAU,EAAE,IAAI,CAAU,CAC5B,CAAC;IACF;;;;OAIG;IACH,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAU,EAAE,IAAe,EAAE,OAAkB,WAAW;IAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAC5E,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,eAAe,CAC1C,KAAK,CAAC,eAAe,EACrB,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CACvC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The shared Playwright layer-3 kit — HOW-TO §23.4, audit rule P-36.
+ *
+ * Six extensions of seven had no end-to-end suite at all, because §23.4 names
+ * six flows that are the same for every one of them and each would have had to
+ * write all six from scratch: a sign-in helper, a theme switcher, a way to find
+ * the shell, a way to drive the agent pop-up. This is those six, written once.
+ * An extension supplies a config file and its own six values.
+ *
+ * Read `README.md` for the values. `locators.ts` is the file a cortena-ui
+ * change breaks, on purpose: once, here, rather than in six suites.
+ */
+export { readCredentials, hasCredentials, environmentName, MissingCredentialsError } from './env.js';
+export type { E2ECredentials } from './env.js';
+export { AGENT, CONSENT, CORTENA_UI, SESSION, SHELL, SIGN_IN, THEME } from './locators.js';
+export { signIn, organisationStep, isSignInScreen, signInScreen, withToken } from './fixtures/sign-in.js';
+export type { SignInOptions } from './fixtures/sign-in.js';
+export { embedded, postHostTheme, expectTokenStrippedFromUrl } from './fixtures/embedded.js';
+export type { EmbeddedOptions } from './fixtures/embedded.js';
+export { theme, expectTheme, themeFromProjectName } from './fixtures/theme.js';
+export type { ThemeMode, ThemePath } from './fixtures/theme.js';
+export { shell, expectShellChrome } from './fixtures/shell.js';
+export type { Shell, ShellExpectations } from './fixtures/shell.js';
+export { popup, expectSessionResumes } from './fixtures/popup.js';
+export type { Popup } from './fixtures/popup.js';
+export { listState } from './fixtures/list-state.js';
+export type { ListStateFilter, ListStateOptions } from './fixtures/list-state.js';
+export { consent, authorizeUrl, deleteClient, discoverAuthorizationServer, discoverProtectedResource, registerClient, signInAtAuthorizationServer, PKCE_CHALLENGE, PKCE_VERIFIER, } from './fixtures/consent.js';
+export type { AuthorizationServerMetadata, ClientRegistration, ConsentOptions, ProtectedResourceMetadata, } from './fixtures/consent.js';
+export { defineProtocolSuite } from './protocol/suite.js';
+export { PROTOCOL_CASE_KEYS } from './protocol/types.js';
+export type { ProtocolCases, ProtocolExpectations, ProtocolSuiteOptions } from './protocol/types.js';
+export { protocolConfig } from './config.js';
+export type { ProtocolConfigOptions } from './config.js';

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * The shared Playwright layer-3 kit — HOW-TO §23.4, audit rule P-36.
+ *
+ * Six extensions of seven had no end-to-end suite at all, because §23.4 names
+ * six flows that are the same for every one of them and each would have had to
+ * write all six from scratch: a sign-in helper, a theme switcher, a way to find
+ * the shell, a way to drive the agent pop-up. This is those six, written once.
+ * An extension supplies a config file and its own six values.
+ *
+ * Read `README.md` for the values. `locators.ts` is the file a cortena-ui
+ * change breaks, on purpose: once, here, rather than in six suites.
+ */
+export { readCredentials, hasCredentials, environmentName, MissingCredentialsError } from './env.js';
+export { AGENT, CONSENT, CORTENA_UI, SESSION, SHELL, SIGN_IN, THEME } from './locators.js';
+export { signIn, organisationStep, isSignInScreen, signInScreen, withToken } from './fixtures/sign-in.js';
+export { embedded, postHostTheme, expectTokenStrippedFromUrl } from './fixtures/embedded.js';
+export { theme, expectTheme, themeFromProjectName } from './fixtures/theme.js';
+export { shell, expectShellChrome } from './fixtures/shell.js';
+export { popup, expectSessionResumes } from './fixtures/popup.js';
+export { listState } from './fixtures/list-state.js';
+export { consent, authorizeUrl, deleteClient, discoverAuthorizationServer, discoverProtectedResource, registerClient, signInAtAuthorizationServer, PKCE_CHALLENGE, PKCE_VERIFIER, } from './fixtures/consent.js';
+export { defineProtocolSuite } from './protocol/suite.js';
+export { PROTOCOL_CASE_KEYS } from './protocol/types.js';
+export { protocolConfig } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGrG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG1G,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAG7F,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,OAAO,EACL,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,2BAA2B,EAAE,yBAAyB,EAC3F,cAAc,EAAE,2BAA2B,EAAE,cAAc,EAAE,aAAa,GAC3E,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}