lib-e2e-cypress-for-dummys-ts 0.8.0 → 0.10.0

package/dist/index.d.cts

@@ -37,6 +37,7 @@ declare class RecordingService {
     private readonly selectorNotFound$;
     private readonly inputDebounceTimers;
     private readonly fixtures;
+    private readonly uploadedFiles;
     private readonly abort;
     selectorStrategy: SelectorStrategy;
     /** Stable id of the current live session (null when none has started). */
@@ -73,6 +74,12 @@ declare class RecordingService {
         name: string;
         content: string;
     }>;
+    addUploadedFile(filename: string, bytes: ArrayBuffer): void;
+    getUploadedFilesSnapshot(): Array<{
+        filename: string;
+        bytes: ArrayBuffer;
+    }>;
+    clearUploadedFiles(): void;
     clearCommands(): void;
     clearInterceptors(): void;
     getCommandsSnapshot(): string[];
@@ -106,6 +113,8 @@ declare class RecordingService {
     private listenToKeys;
     private listenToInput;
     private listenToSelect;
+    private handleFileInputChange;
+    private readFileAsArrayBuffer;
     private listenToRouteChanges;
     private handleClickEvent;
     private handleMatOptionClick;
@@ -153,48 +162,6 @@ declare const RESUME_TTL_CONFIG_KEY = "resumeRecencyTtlMinutes";
 /** Default minutes within which an active session resumes silently. */
 declare const DEFAULT_RESUME_TTL_MINUTES = 30;
 
-/**
- * Issue-tracker presets for the *link-only* ticket reference (spec 014).
- *
- * These are static, data-driven descriptors — there is NO API call, no auth and
- * no synchronisation. A provider only knows how to turn a ticket id plus a few
- * user-supplied fields into a deep link. Adding a new tracker is a single entry
- * in {@link ISSUE_TRACKER_PROVIDERS}; no new code paths are required.
- */
-/** A single user-configured field a provider needs to build its links. */
-interface IssueTrackerField {
-    /** Token used in {@link IssueTrackerProvider.urlTemplate}, e.g. `org`. */
-    key: string;
-    /** i18n key for the field's label in the configuration panel. */
-    labelKey: string;
-    /** i18n key for the field's input placeholder. */
-    placeholderKey: string;
-}
-/** A link-only issue-tracker descriptor. */
-interface IssueTrackerProvider {
-    /** Stable id persisted in configuration, e.g. `jira`. */
-    id: string;
-    /** Display name — a proper noun (Jira, GitHub…), not translated. */
-    labelKey: string;
-    /**
-     * URL template with `{id}` plus one token per field. For `custom` the template
-     * itself comes from a field (`{template}`), so a single substitution path serves
-     * every provider.
-     */
-    urlTemplate: string;
-    /** Structured fields the user fills in Settings for this provider. */
-    fields: IssueTrackerField[];
-    /** Regex source used for a soft (non-blocking) id-format warning. */
-    idPattern: string;
-    /** i18n key for the ticket-id input placeholder in the save dialog. */
-    idPlaceholderKey: string;
-}
-declare const ISSUE_TRACKER_PROVIDERS: IssueTrackerProvider[];
-/** Feature is inert until configured: default to a custom, empty template. */
-declare const DEFAULT_ISSUE_TRACKER_PROVIDER_ID = "custom";
-/** Looks up a provider by id, or `undefined` when unknown. */
-declare function findIssueTrackerProvider(id: string): IssueTrackerProvider | undefined;
-
 declare class TranslationService {
     private readonly lang$;
     private readonly translations;
@@ -232,13 +199,13 @@ declare class AdvancedTestTransformationService {
 }
 declare const advancedTestTransformationService: AdvancedTestTransformationService;
 
-declare class Subject<T> {
-    private _value;
-    private listeners;
-    constructor(initialValue: T);
-    next(value: T): void;
-    getValue(): T;
-    subscribe(fn: (v: T) => void): () => void;
+interface LoginSetupConfig {
+    enabled: boolean;
+    filePath: string;
+    fileContent: string;
+    detectedFunctions: string[];
+    beforeFn: string | null;
+    beforeEachFn: string | null;
 }
 
 interface TestRecord {
@@ -282,12 +249,6 @@ declare class PersistenceService {
     insertTest(name: string, commands?: string[], interceptors?: string[], tags?: string[], notes?: string, ticketId?: string): Promise<number>;
     getAllTests(): Promise<TestWithDetails[]>;
     getTestById(testId: number): Promise<TestDetail | null>;
-    /**
-     * Builds the traceability comment for a test record (spec 014), reading the
-     * configured issue-tracker provider/params so the link — when resolvable — is
-     * embedded. Returns `null` when the record has no ticket id.
-     */
-    private ticketCommentFor;
     deleteTest(id: number): Promise<void>;
     insertCommands(commands: string[], testId: number): Promise<void>;
     getCommandsByTestId(testId: number): Promise<CommandRecord[]>;
@@ -301,6 +262,10 @@ declare class PersistenceService {
     setConfigKey(key: string, value: unknown): Promise<void>;
     getConfig(key: string): Promise<Record<string, unknown> | null>;
     getGeneralConfig(): Promise<ConfigRecord | null>;
+    private static readonly LOGIN_SETUP_KEY;
+    saveLoginSetup(config: LoginSetupConfig): Promise<void>;
+    getLoginSetup(): Promise<LoginSetupConfig | null>;
+    clearLoginSetup(): Promise<void>;
     /** Upserts the live recording session (single record, fixed key). */
     saveActiveSession(state: ActiveSessionState): Promise<void>;
     /** Returns the persisted live session, or null when none is stored. */
@@ -309,6 +274,8 @@ declare class PersistenceService {
     clearActiveSession(): Promise<void>;
     clearAllData(): Promise<void>;
     ingestFileData(tests: Record<string, unknown>[], interceptors: Record<string, unknown>[]): Promise<void>;
+    hasDirectoryAccess(): Promise<boolean>;
+    writeUploadedFile(filename: string, bytes: ArrayBuffer): Promise<void>;
     requestDirectoryPermissions(): Promise<void>;
     /**
      * Writes captured fixtures into `cypress/fixtures/` using the configured Cypress
@@ -321,24 +288,17 @@ declare class PersistenceService {
     }>): Promise<number>;
     private bulkInsertWithoutId;
 }
-declare const persistenceService: PersistenceService;
 
 declare function generateAlias(method: string, url: string): string;
+/** @internal — resets singleton state between test suites; do not use in production code */
+declare function _resetHttpMonitorState(): void;
 declare class HttpMonitor {
     private readonly recording;
-    private originalFetch;
-    private originalXHR;
     constructor(recording: RecordingService);
     install(): void;
     uninstall(): void;
     isExtendedHttpEnabled(): boolean;
     isFixtureModeEnabled(): boolean;
-    private installFetch;
-    private uninstallFetch;
-    private installXhr;
-    private uninstallXhr;
-    private handleFetchInterception;
-    private handleXhrInterception;
 }
 
 declare const SCROLLBAR_STYLES = "\n.swal2-popup::-webkit-scrollbar,\n.swal2-html-container::-webkit-scrollbar,\n.swal2-content::-webkit-scrollbar,\n.swal2-container::-webkit-scrollbar {\n  width: 5px;\n  height: 5px;\n  background: transparent;\n}\n.swal2-popup::-webkit-scrollbar-thumb,\n.swal2-html-container::-webkit-scrollbar-thumb,\n.swal2-content::-webkit-scrollbar-thumb,\n.swal2-container::-webkit-scrollbar-thumb {\n  background: #30363d;\n  border-radius: 3px;\n}\n.swal2-popup::-webkit-scrollbar-thumb:hover,\n.swal2-html-container::-webkit-scrollbar-thumb:hover,\n.swal2-content::-webkit-scrollbar-thumb:hover {\n  background: #484f58;\n}\n.swal2-popup::-webkit-scrollbar-track,\n.swal2-html-container::-webkit-scrollbar-track,\n.swal2-content::-webkit-scrollbar-track,\n.swal2-container::-webkit-scrollbar-track {\n  background: transparent;\n}\n.swal2-popup, .swal2-html-container, .swal2-content, .swal2-container {\n  scrollbar-width: thin;\n  scrollbar-color: #30363d transparent;\n}\n";
@@ -352,6 +312,7 @@ declare function makeModalResizable(modal: HTMLElement, options?: {
 declare function makeSwalDraggable(): void;
 declare function makeSwalDraggableByContentId(contentId: string): void;
 declare function setSwal2DataCyAttribute(dataCy?: string): void;
+declare function ensurePopupDimensions(popup: HTMLElement | null, heightPx: number): void;
 
 declare function showToast(message: string, isSuccess?: boolean): void;
 
@@ -431,71 +392,6 @@ declare function boxTopLeftFor(toggleCentre: Point, dir: ExpandDirection): Point
  */
 declare function inferAssertionCommand(el: HTMLElement, selector: string): string;
 
-/**
- * Ticket-reference helpers for the link-only issue-tracker feature (spec 014).
- *
- * Pure functions: no DOM, no network. `buildTicketUrl` never trusts its inputs —
- * it only returns a URL when the result parses to a safe `http(s)` link, which is
- * what guards a user-supplied custom template from `javascript:`/`data:` injection.
- */
-/**
- * Resolves a provider template into a deep link for `id`.
- *
- * Substitutes each `{fieldKey}` (custom's `{template}` first, so a template that
- * itself contains `{id}` is handled by the same path) and then `{id}` (URL-encoded).
- * Returns `null` when a required field is missing, a token is left unresolved, or
- * the result is not a valid `http:`/`https:` URL.
- */
-declare function buildTicketUrl(provider: IssueTrackerProvider, params: Record<string, string>, id: string): string | null;
-/**
- * Convenience wrapper for the configuration shape: looks up the provider by id and
- * picks its field values out of the per-provider `allParams` map before delegating
- * to {@link buildTicketUrl}. Returns `null` for an unknown provider, an empty id, or
- * any input that would not resolve to a safe `http(s)` link.
- */
-declare function resolveTicketUrl(providerId: string, allParams: Record<string, Record<string, string>>, ticketId?: string): string | null;
-/**
- * Builds the traceability comment emitted above the generated `it()` block:
- * `// {id} — {url}` when a link is available, otherwise `// {id}`.
- */
-declare function buildTicketComment(id: string, url: string | null): string;
-
-/**
- * Hand-authored Cypress autocomplete data (spec 013). Pure — no CodeMirror — so
- * it is unit-testable; `code-editor.ts` wraps it into a CodeMirror CompletionSource.
- */
-/** Methods offered after typing `cy.` */
-declare const CY_METHODS: string[];
-/** Methods offered after a chained `.` (e.g. `cy.get('x').`). */
-declare const CHAIN_METHODS: string[];
-/** Top-level identifiers offered at the start of a statement. */
-declare const TOP_LEVEL: string[];
-/** All completion labels (used for the pure filter and tests). */
-declare const CYPRESS_COMPLETIONS: string[];
-/** Case-insensitive substring filter over a label list. */
-declare function filterCompletions(list: string[], prefix: string): string[];
-/** Convenience filter over the full completion set. */
-declare function filterCypressCompletions(prefix: string): string[];
-
-/**
- * Lazy CodeMirror 6 factory for the code editor (spec 013). CodeMirror is loaded
- * on demand (its own chunk) via dynamic import, so it never bloats the initial
- * bundle. Browser-only; not exercised in jsdom (see the file-preview fallback).
- */
-interface CodeEditorHandle {
-    getValue(): string;
-    setValue(value: string): void;
-    focus(): void;
-    destroy(): void;
-}
-interface CreateCodeEditorOptions {
-    parent: HTMLElement;
-    root?: Document | ShadowRoot;
-    doc: string;
-    onChange?: (value: string) => void;
-}
-declare function createCodeEditor(opts: CreateCodeEditorOptions): Promise<CodeEditorHandle>;
-
 declare class SelectorPickerElement extends HTMLElement {
     targetElement: HTMLElement | null;
     recording: RecordingService;
@@ -547,29 +443,37 @@ declare class TestPrevisualizerElement extends HTMLElement {
     private render;
 }
 
+type IssueTrackerProvider = 'jira' | 'github' | 'gitlab' | 'azure' | 'bitbucket' | 'custom';
+interface IssueTrackerConfig {
+    enabled: boolean;
+    provider: IssueTrackerProvider;
+    baseUrl: string;
+}
+
 declare class SaveTestElement extends HTMLElement {
     private shadow;
     private _step;
+    private _stepBeforeDiscard;
     description: string;
     notes: string;
     tags: string[];
     ticketId: string;
-    /** Set by the host from config so the ticket placeholder/validation is provider-aware. */
-    issueTrackerProviderId: string;
+    issueTrackerConfig: IssueTrackerConfig;
     translation: TranslationService;
     constructor();
     connectedCallback(): void;
-    get step(): 'ask' | 'desc';
+    get step(): 'ask' | 'desc' | 'confirm-discard';
     askSave(): void;
     confirmSave(): void;
     confirmSaveAndExport(): void;
     cancel(): void;
+    confirmDiscard(): void;
+    backFromDiscard(): void;
     restartComponent(): void;
     addTag(tag: string): void;
     removeTag(tag: string): void;
     private t;
-    /** Builds the ticket field view: provider-aware placeholder + soft (non-blocking) format check. */
-    private ticketView;
+    get ticketIdWarning(): boolean;
     private dispatch;
     private render;
 }
@@ -586,15 +490,14 @@ declare class TestEditorElement extends HTMLElement {
     selectedIds: Set<number>;
     describeName: string;
     groupByTicket: boolean;
-    issueTrackerProviderId: string;
-    issueTrackerParams: Record<string, Record<string, string>>;
+    issueTrackerConfig: IssueTrackerConfig;
     constructor();
     connectedCallback(): void;
     loadTests(): Promise<void>;
-    toggleGroupByTicket(): void;
     deleteTest(id: number): Promise<void>;
     toggleExpand(index: number): void;
     hasInterceptors(testId: number): boolean;
+    toggleGroupByTicket(): void;
     toggleSelectMode(): void;
     toggleSelectTest(id: number): void;
     generateDescribe(): void;
@@ -616,13 +519,21 @@ declare class ConfigurationElement extends HTMLElement {
     smartSelectorEnabled: boolean;
     startHidden: boolean;
     resumeTtlMinutes: number;
-    issueTrackerProviderId: string;
-    issueTrackerParams: Record<string, Record<string, string>>;
     isExporting: boolean;
     exportMode: ExportMode;
     exportTests: TestWithDetails[];
     exportSelectedIds: Set<number>;
     exportSelectedTags: Set<string>;
+    issueTrackerConfig: IssueTrackerConfig;
+    isLoginSetupOpen: boolean;
+    loginSetupConfig: LoginSetupConfig | null;
+    loginSetupDraftPath: string;
+    loginSetupDraftFunctions: string[];
+    loginSetupDraftBeforeFn: string | null;
+    loginSetupDraftBeforeEachFn: string | null;
+    loginSetupDraftHasContent: boolean;
+    private loginSetupDraftHandle;
+    private loginSetupDraftContent;
     private filesystemGranted;
     private cypressFolderName;
     constructor();
@@ -634,13 +545,19 @@ declare class ConfigurationElement extends HTMLElement {
     onFixtureModeChange(checked: boolean): void;
     onStartHiddenChange(checked: boolean): Promise<void>;
     onResumeTtlChange(minutes: number): Promise<void>;
-    /** Selects the issue-tracker provider (link-only, no sync — spec 014). */
-    onIssueTrackerProviderChange(id: string): Promise<void>;
-    /** Stores a provider field value, scoped to the active provider so switching keeps values. */
-    onIssueTrackerParamChange(fieldKey: string, value: string): Promise<void>;
     onResetWidgetPosition(): void;
     onSmartSelectorChange(enabled: boolean): Promise<void>;
     onSelectorStrategyChange(strategy: SelectorStrategy): Promise<void>;
+    onIssueTrackerEnabledChange(enabled: boolean): Promise<void>;
+    onIssueTrackerProviderChange(provider: IssueTrackerProvider): Promise<void>;
+    onIssueTrackerBaseUrlChange(baseUrl: string): Promise<void>;
+    openLoginSetupPanel(): void;
+    closeLoginSetupPanel(): void;
+    saveLoginSetupConfig(config: LoginSetupConfig): Promise<void>;
+    clearLoginSetupConfig(): Promise<void>;
+    loginSetupPickFile(): Promise<void>;
+    loginSetupCreateScaffold(): Promise<void>;
+    loginSetupRescan(): Promise<void>;
     changeFolder(): Promise<void>;
     revokeAccess(): Promise<void>;
     private downloadTests;
@@ -679,6 +596,7 @@ declare class AdvancedTestEditorElement extends HTMLElement {
     isCreatingFolder: boolean;
     collapsedDirs: Set<string>;
     sidebarWidth: number;
+    loginSetupConfig: LoginSetupConfig | null;
     private hasPermission;
     private needsReauth;
     private _dirHandle;
@@ -706,7 +624,6 @@ declare class AdvancedTestEditorElement extends HTMLElement {
 declare class FilePreviewElement extends HTMLElement {
     private shadow;
     private textarea;
-    private editor;
     fileName: string | null;
     closeLabel: string;
     translation: TranslationService;
@@ -726,10 +643,7 @@ declare class FilePreviewElement extends HTMLElement {
     private _runOutput;
     constructor();
     connectedCallback(): void;
-    disconnectedCallback(): void;
     private t;
-    /** Current editor content (CodeMirror if upgraded, else the textarea/fallback). */
-    private currentValue;
     get fileContent(): string | null;
     set fileContent(v: string | null);
     saveFile(): void;
@@ -750,12 +664,6 @@ declare class FilePreviewElement extends HTMLElement {
      */
     insertBlocks(): void;
     private render;
-    /**
-     * Lazily upgrades the textarea to a CodeMirror editor (syntax highlight +
-     * Cypress autocomplete). On any failure the textarea is left in place, so the
-     * editor degrades gracefully when CodeMirror can't load.
-     */
-    private upgradeEditor;
 }
 
 /**
@@ -796,6 +704,7 @@ declare class LibE2eRecorderElement extends HTMLElement {
     private httpMonitor?;
     private smartSelectorEnabled;
     private _needsRecordingRebuild;
+    private issueTrackerConfig;
     recording: RecordingService;
     persistence: PersistenceService;
     translation: TranslationService;
@@ -873,13 +782,12 @@ declare class LibE2eRecorderElement extends HTMLElement {
     private showFileEditorDialog;
     private onSaveTest;
     private onSaveAndExportTest;
-    /** Writes captured fixtures to cypress/fixtures and toasts the outcome (spec 012). */
-    private writeFixturesIfAny;
     private toggleModal;
     private resizePopup;
+    private openSwalDialog;
     private render;
 }
 
-declare const VERSION = "0.8.0";
+declare const VERSION = "0.10.0";
 
-export { ACTIVE_SESSION_BREADCRUMB_KEY, type ActiveSessionState, AdvancedTestEditorElement, AdvancedTestTransformationService, CHAIN_METHODS, CYPRESS_COMPLETIONS, CY_METHODS, type CodeEditorHandle, ConfigurationElement, type CreateCodeEditorOptions, type DBSchema, type DBStore, type DBStoreIndex, DB_SCHEMA, DB_STORE_NAMES, DEFAULT_ISSUE_TRACKER_PROVIDER_ID, DEFAULT_RESUME_TTL_MINUTES, DRAG_THRESHOLD, type DirectoryNode, type ExpandDirection, type ExportMode, type ExportSelectionOptions, type FileNode, FilePreviewElement, HelpPanelElement, HttpMonitor, INPUT_TYPES, ISSUE_TRACKER_PROVIDERS, type InputType, type IssueTrackerField, type IssueTrackerProvider, LIB_E2E_CYPRESS_FOR_DUMMYS_SWAL2_STYLES, LOCALE_BY_LANG, type Lang, LibE2eRecorderElement, PersistenceService, type Point, RESUME_TTL_CONFIG_KEY, RecordingService, SCROLLBAR_STYLES, SUPPORTED_LANGS, SaveTestElement, SelectorPickerElement, type SelectorStrategy, Subject, TOGGLE_MARGIN, TOP_LEVEL, type TestDetail, TestEditorElement, TestPrevisualizerElement, type TestWithDetails, TransformationService, TranslationService, VERSION, advancedTestTransformationService, boxOffsetForDirection, boxTopLeftFor, buildTicketComment, buildTicketUrl, clampTogglePosition, createCodeEditor, defaultTogglePosition, filterCompletions, filterCypressCompletions, findIssueTrackerProvider, generateAlias, inferAssertionCommand, injectStyles, isLang, isLocalHost, localeForLang, makeModalResizable, makeSwalDraggable, makeSwalDraggableByContentId, persistenceService, resolveExpandDirection, resolveTicketUrl, selectTestsForExport, setSwal2DataCyAttribute, showToast, transformationService, translationService };
+export { ACTIVE_SESSION_BREADCRUMB_KEY, type ActiveSessionState, AdvancedTestEditorElement, AdvancedTestTransformationService, ConfigurationElement, type DBSchema, type DBStore, type DBStoreIndex, DB_SCHEMA, DB_STORE_NAMES, DEFAULT_RESUME_TTL_MINUTES, DRAG_THRESHOLD, type DirectoryNode, type ExpandDirection, type ExportMode, type ExportSelectionOptions, type FileNode, FilePreviewElement, HelpPanelElement, HttpMonitor, INPUT_TYPES, type InputType, LIB_E2E_CYPRESS_FOR_DUMMYS_SWAL2_STYLES, LOCALE_BY_LANG, type Lang, LibE2eRecorderElement, PersistenceService, type Point, RESUME_TTL_CONFIG_KEY, RecordingService, SCROLLBAR_STYLES, SUPPORTED_LANGS, SaveTestElement, SelectorPickerElement, type SelectorStrategy, TOGGLE_MARGIN, type TestDetail, TestEditorElement, TestPrevisualizerElement, type TestWithDetails, TransformationService, TranslationService, VERSION, _resetHttpMonitorState, advancedTestTransformationService, boxOffsetForDirection, boxTopLeftFor, clampTogglePosition, defaultTogglePosition, ensurePopupDimensions, generateAlias, inferAssertionCommand, injectStyles, isLang, isLocalHost, localeForLang, makeModalResizable, makeSwalDraggable, makeSwalDraggableByContentId, resolveExpandDirection, selectTestsForExport, setSwal2DataCyAttribute, showToast, transformationService, translationService };