@hotwired/turbo 7.0.0-rc.5 → 7.1.0-rc.2

package/dist/types/core/drive/form_submission.d.ts

@@ -36,6 +36,7 @@ export declare class FormSubmission {
     readonly mustRedirect: boolean;
     state: FormSubmissionState;
     result?: FormSubmissionResult;
+    static confirmMethod(message: string, element: HTMLFormElement): boolean;
     constructor(delegate: FormSubmissionDelegate, formElement: HTMLFormElement, submitter?: HTMLElement, mustRedirect?: boolean);
     get method(): FetchMethod;
     get action(): string;
@@ -44,6 +45,8 @@ export declare class FormSubmission {
     get enctype(): FormEnctype;
     get isIdempotent(): boolean;
     get stringFormData(): [string, string][];
+    get confirmationMessage(): string | null;
+    get needsConfirmation(): boolean;
     start(): Promise<void | FetchResponse>;
     stop(): true | undefined;
     prepareHeadersForRequest(headers: FetchRequestHeaders, request: FetchRequest): void;

package/dist/types/core/drive/page_view.d.ts

@@ -10,10 +10,10 @@ declare type PageViewRenderer = PageRenderer | ErrorRenderer;
 export declare class PageView extends View<Element, PageSnapshot, PageViewRenderer, PageViewDelegate> {
     readonly snapshotCache: SnapshotCache;
     lastRenderedLocation: URL;
-    renderPage(snapshot: PageSnapshot, isPreview?: boolean): Promise<void>;
+    renderPage(snapshot: PageSnapshot, isPreview?: boolean, willRender?: boolean): Promise<void>;
     renderError(snapshot: PageSnapshot): Promise<void>;
     clearSnapshotCache(): void;
-    cacheSnapshot(): Promise<void>;
+    cacheSnapshot(): Promise<PageSnapshot | undefined>;
     getCachedSnapshotForLocation(location: URL): PageSnapshot | undefined;
     get snapshot(): PageSnapshot;
     get shouldCacheSnapshot(): boolean;

package/dist/types/core/drive/visit.d.ts

@@ -2,6 +2,7 @@ import { Adapter } from "../native/adapter";
 import { FetchRequest, FetchRequestDelegate } from "../../http/fetch_request";
 import { FetchResponse } from "../../http/fetch_response";
 import { History } from "./history";
+import { Snapshot } from "../snapshot";
 import { PageSnapshot } from "./page_snapshot";
 import { Action } from "../types";
 import { PageView } from "./page_view";
@@ -36,9 +37,12 @@ export declare type VisitOptions = {
     referrer?: URL;
     snapshotHTML?: string;
     response?: VisitResponse;
+    visitCachedSnapshot(snapshot: Snapshot): void;
+    willRender: boolean;
 };
 export declare type VisitResponse = {
     statusCode: number;
+    redirected: boolean;
     responseHTML?: string;
 };
 export declare enum SystemStatusCode {
@@ -53,6 +57,8 @@ export declare class Visit implements FetchRequestDelegate {
     readonly action: Action;
     readonly referrer?: URL;
     readonly timingMetrics: TimingMetrics;
+    readonly visitCachedSnapshot: (snapshot: Snapshot) => void;
+    readonly willRender: boolean;
     followedRedirect: boolean;
     frame?: number;
     historyChanged: boolean;

package/dist/types/core/frames/frame_controller.d.ts

@@ -16,6 +16,8 @@ export declare class FrameController implements AppearanceObserverDelegate, Fetc
     readonly formInterceptor: FormInterceptor;
     currentURL?: string | null;
     formSubmission?: FormSubmission;
+    fetchResponseLoaded: (fetchResponse: FetchResponse) => void;
+    private currentFetchRequest;
     private resolveVisitPromise;
     private connected;
     private hasBeenLoaded;
@@ -31,7 +33,7 @@ export declare class FrameController implements AppearanceObserverDelegate, Fetc
     elementAppearedInViewport(element: Element): void;
     shouldInterceptLinkClick(element: Element, url: string): boolean;
     linkClickIntercepted(element: Element, url: string): void;
-    shouldInterceptFormSubmission(element: HTMLFormElement, submitter?: Element): boolean;
+    shouldInterceptFormSubmission(element: HTMLFormElement, submitter?: HTMLElement): boolean;
     formSubmissionIntercepted(element: HTMLFormElement, submitter?: HTMLElement): void;
     prepareHeadersForRequest(headers: FetchRequestHeaders, request: FetchRequest): void;
     requestStarted(request: FetchRequest): void;
@@ -40,18 +42,20 @@ export declare class FrameController implements AppearanceObserverDelegate, Fetc
     requestFailedWithResponse(request: FetchRequest, response: FetchResponse): void;
     requestErrored(request: FetchRequest, error: Error): void;
     requestFinished(request: FetchRequest): void;
-    formSubmissionStarted(formSubmission: FormSubmission): void;
+    formSubmissionStarted({ formElement }: FormSubmission): void;
     formSubmissionSucceededWithResponse(formSubmission: FormSubmission, response: FetchResponse): void;
     formSubmissionFailedWithResponse(formSubmission: FormSubmission, fetchResponse: FetchResponse): void;
     formSubmissionErrored(formSubmission: FormSubmission, error: Error): void;
-    formSubmissionFinished(formSubmission: FormSubmission): void;
+    formSubmissionFinished({ formElement }: FormSubmission): void;
     allowsImmediateRender(snapshot: Snapshot, resume: (value: any) => void): boolean;
     viewRenderedSnapshot(snapshot: Snapshot, isPreview: boolean): void;
     viewInvalidated(): void;
     private visit;
     private navigateFrame;
+    private proposeVisitIfNavigatedWithAction;
     private findFrameElement;
     extractForeignFrameElement(container: ParentNode): Promise<FrameElement>;
+    private formActionIsVisitable;
     private shouldInterceptNavigation;
     get id(): string;
     get enabled(): boolean;
@@ -62,4 +66,5 @@ export declare class FrameController implements AppearanceObserverDelegate, Fetc
     get loadingStyle(): FrameLoadingStyle;
     get isLoading(): boolean;
     get isActive(): boolean;
+    get rootLocation(): URL;
 }

package/dist/types/core/frames/frame_redirector.d.ts

@@ -11,6 +11,7 @@ export declare class FrameRedirector implements LinkInterceptorDelegate, FormInt
     linkClickIntercepted(element: Element, url: string): void;
     shouldInterceptFormSubmission(element: HTMLFormElement, submitter?: HTMLElement): boolean;
     formSubmissionIntercepted(element: HTMLFormElement, submitter?: HTMLElement): void;
+    private shouldSubmit;
     private shouldRedirect;
     private findFrameElement;
 }

package/dist/types/core/index.d.ts

@@ -17,3 +17,4 @@ export declare function disconnectStreamSource(source: StreamSource): void;
 export declare function renderStreamMessage(message: StreamMessage | string): void;
 export declare function clearCache(): void;
 export declare function setProgressBarDelay(delay: number): void;
+export declare function setConfirmMethod(confirmMethod: (message: string, element: HTMLFormElement) => boolean): void;

package/dist/types/core/renderer.d.ts

@@ -3,9 +3,10 @@ export declare abstract class Renderer<E extends Element, S extends Snapshot<E>
     readonly currentSnapshot: S;
     readonly newSnapshot: S;
     readonly isPreview: boolean;
+    readonly willRender: boolean;
     readonly promise: Promise<void>;
     private resolvingFunctions?;
-    constructor(currentSnapshot: S, newSnapshot: S, isPreview: boolean);
+    constructor(currentSnapshot: S, newSnapshot: S, isPreview: boolean, willRender?: boolean);
     get shouldRender(): boolean;
     prepareToRender(): void;
     abstract render(): Promise<void>;

package/dist/types/core/session.d.ts

@@ -82,6 +82,6 @@ export declare class Session implements FormSubmitObserverDelegate, HistoryDeleg
     notifyApplicationAfterFrameRender(fetchResponse: FetchResponse, frame: FrameElement): CustomEvent<any>;
     elementDriveEnabled(element?: Element): boolean;
     getActionForLink(link: Element): Action;
-    locationIsVisitable(location: URL): boolean;
+    getTargetFrameForLink(link: Element): string | undefined;
     get snapshot(): PageSnapshot;
 }

package/dist/types/core/url.d.ts

@@ -1,9 +1,11 @@
 export declare type Locatable = URL | string;
 export declare function expandURL(locatable: Locatable): URL;
 export declare function getAnchor(url: URL): string | undefined;
+export declare function getAction(form: HTMLFormElement, submitter?: HTMLElement): URL;
 export declare function getExtension(url: URL): string;
 export declare function isHTML(url: URL): boolean;
 export declare function isPrefixedBy(baseURL: URL, url: URL): boolean;
+export declare function locationIsVisitable(location: URL, rootLocation: URL): boolean;
 export declare function getRequestURL(url: URL): string;
 export declare function toCacheKey(url: URL): string;
 export declare function urlsAreEqual(left: string, right: string): boolean;

package/dist/types/elements/frame_element.d.ts

@@ -10,7 +10,9 @@ export interface FrameElementDelegate {
     sourceURLChanged(): void;
     disabledChanged(): void;
     formSubmissionIntercepted(element: HTMLFormElement, submitter?: HTMLElement): void;
+    linkClickIntercepted(element: Element, url: string): void;
     loadResponse(response: FetchResponse): void;
+    fetchResponseLoaded: (fetchResponse: FetchResponse) => void;
     isLoading: boolean;
 }
 export declare class FrameElement extends HTMLElement {

package/dist/types/polyfills/index.d.ts

@@ -1,2 +1,3 @@
 import "./custom-elements-native-shim";
+import "./form-request-submit-polyfill";
 import "./submit-event";

package/dist/types/tests/functional/drive_disabled_tests.d.ts

@@ -4,4 +4,6 @@ export declare class DriveDisabledTests extends TurboDriveTestCase {
     setup(): Promise<void>;
     "test drive disabled by default; click normal link"(): Promise<void>;
     "test drive disabled by default; click link inside data-turbo='true'"(): Promise<void>;
+    "test drive disabled by default; submit form inside data-turbo='true'"(): Promise<void>;
+    get formSubmitted(): Promise<boolean>;
 }

package/dist/types/tests/functional/drive_tests.d.ts

@@ -3,5 +3,6 @@ export declare class DriveTests extends TurboDriveTestCase {
     path: string;
     setup(): Promise<void>;
     "test drive enabled by default; click normal link"(): Promise<void>;
+    "test drive to external link"(): Promise<void>;
     "test drive enabled by default; click link inside data-turbo='false'"(): Promise<void>;
 }

package/dist/types/tests/functional/form_submission_tests.d.ts

@@ -2,9 +2,16 @@ import { TurboDriveTestCase } from "../helpers/turbo_drive_test_case";
 export declare class FormSubmissionTests extends TurboDriveTestCase {
     setup(): Promise<void>;
     "test standard form submission renders a progress bar"(): Promise<void>;
+    "test form submission with confirmation confirmed"(): Promise<void>;
+    "test form submission with confirmation cancelled"(): Promise<void>;
+    "test from submission with confirmation overriden"(): Promise<void>;
     "test standard form submission does not render a progress bar before expiring the delay"(): Promise<void>;
     "test standard form submission with redirect response"(): Promise<void>;
+    "test standard POST form submission events"(): Promise<void>;
+    "test standard POST form submission toggles submitter [disabled] attribute"(): Promise<void>;
     "test standard GET form submission"(): Promise<void>;
+    "test standard GET form submission events"(): Promise<void>;
+    "test standard GET form submission toggles submitter [disabled] attribute"(): Promise<void>;
     "test standard GET form submission appending keys"(): Promise<void>;
     "test standard form submission with empty created response"(): Promise<void>;
     "test standard form submission with empty no-content response"(): Promise<void>;
@@ -25,11 +32,15 @@ export declare class FormSubmissionTests extends TurboDriveTestCase {
     "test submitter POST submission from submitter with data-turbo-frame"(): Promise<void>;
     "test frame form GET submission from submitter with data-turbo-frame=_top"(): Promise<void>;
     "test frame form POST submission from submitter with data-turbo-frame=_top"(): Promise<void>;
+    "test frame POST form targetting frame submission"(): Promise<void>;
+    "test frame POST form targetting frame toggles submitter's [disabled] attribute"(): Promise<void>;
+    "test frame GET form targetting frame submission"(): Promise<void>;
+    "test frame GET form targetting frame toggles submitter's [disabled] attribute"(): Promise<void>;
     "test frame form GET submission from submitter referencing another frame"(): Promise<void>;
     "test frame form POST submission from submitter referencing another frame"(): Promise<void>;
     "test frame form submission with redirect response"(): Promise<void>;
-    "test frame form submission toggles the ancestor frame's [busy] attribute"(): Promise<void>;
-    "test frame form submission toggles the target frame's [busy] attribute"(): Promise<void>;
+    "test frame form submission toggles the ancestor frame's [aria-busy] attribute"(): Promise<void>;
+    "test frame form submission toggles the target frame's [aria-busy] attribute"(): Promise<void>;
     "test frame form submission with empty created response"(): Promise<void>;
     "test frame form submission with empty no-content response"(): Promise<void>;
     "test frame form submission within a frame submits the Turbo-Frame header"(): Promise<void>;
@@ -43,11 +54,26 @@ export declare class FormSubmissionTests extends TurboDriveTestCase {
     "test form submission with [data-turbo=false] on the submitter"(): Promise<void>;
     "test form submission skipped within method=dialog"(): Promise<void>;
     "test form submission skipped with submitter formmethod=dialog"(): Promise<void>;
+    "test form submission targetting frame skipped within method=dialog"(): Promise<void>;
+    "test form submission targetting frame skipped with submitter formmethod=dialog"(): Promise<void>;
     "test form submission targets disabled frame"(): Promise<void>;
     "test form submission targeting a frame submits the Turbo-Frame header"(): Promise<void>;
     "test link method form submission inside frame"(): Promise<void>;
+    "test link method form submission inside frame with data-turbo-frame=_top"(): Promise<void>;
+    "test link method form submission inside frame with data-turbo-frame target"(): Promise<void>;
+    "test stream link method form submission inside frame"(): Promise<void>;
+    "test link method form submission within form inside frame"(): Promise<void>;
+    "test link method form submission inside frame with confirmation confirmed"(): Promise<void>;
+    "test link method form submission inside frame with confirmation cancelled"(): Promise<void>;
     "test link method form submission outside frame"(): Promise<void>;
+    "test stream link method form submission outside frame"(): Promise<void>;
+    "test link method form submission within form outside frame"(): Promise<void>;
+    "test stream link method form submission within form outside frame"(): Promise<void>;
     "test turbo:before-fetch-request fires on the form element"(): Promise<void>;
     "test turbo:before-fetch-response fires on the form element"(): Promise<void>;
-    get formSubmitted(): Promise<boolean>;
+    "test POST to external action ignored"(): Promise<void>;
+    "test POST to external action within frame ignored"(): Promise<void>;
+    "test POST to external action targetting frame ignored"(): Promise<void>;
+    get formSubmitStarted(): Promise<boolean>;
+    get formSubmitEnded(): Promise<boolean>;
 }

package/dist/types/tests/functional/frame_tests.d.ts

@@ -1,13 +1,17 @@
 import { TurboDriveTestCase } from "../helpers/turbo_drive_test_case";
 export declare class FrameTests extends TurboDriveTestCase {
     setup(): Promise<void>;
+    "test navigating a frame a second time does not leak event listeners"(): Promise<void>;
     "test following a link preserves the current <turbo-frame> element's attributes"(): Promise<void>;
     "test a frame whose src references itself does not infinitely loop"(): Promise<void>;
-    "test following a link driving a frame toggles the [busy] attribute"(): Promise<void>;
+    "test following a link driving a frame toggles the [aria-busy=true] attribute"(): Promise<void>;
     "test following a link to a page without a matching frame results in an empty frame"(): Promise<void>;
     "test following a link within a frame with a target set navigates the target frame"(): Promise<void>;
+    "test following a link in rapid succession cancels the previous request"(): Promise<void>;
     "test following a link within a descendant frame whose ancestor declares a target set navigates the descendant frame"(): Promise<void>;
     "test following a link that declares data-turbo-frame within a frame whose ancestor respects the override"(): Promise<void>;
+    "test following a form within a nested frame with form target top"(): Promise<void>;
+    "test following a form within a nested frame with child frame target top"(): Promise<void>;
     "test following a link within a frame with target=_top navigates the page"(): Promise<void>;
     "test following a link that declares data-turbo-frame='_self' within a frame with target=_top navigates the frame itself"(): Promise<void>;
     "test following a link to a page with a <turbo-frame recurse> which lazily loads a matching frame"(): Promise<void>;
@@ -17,14 +21,32 @@ export declare class FrameTests extends TurboDriveTestCase {
     "test does not evaluate data-turbo-eval=false scripts"(): Promise<void>;
     "test redirecting in a form is still navigatable after redirect"(): Promise<void>;
     "test 'turbo:frame-render' is triggered after frame has finished rendering"(): Promise<void>;
+    "test navigating a frame fires events"(): Promise<void>;
     "test following inner link reloads frame on every click"(): Promise<void>;
     "test following outer link reloads frame on every click"(): Promise<void>;
     "test following outer form reloads frame on every submit"(): Promise<void>;
     "test an inner/outer link reloads frame on every click"(): Promise<void>;
     "test an inner/outer form reloads frame on every submit"(): Promise<void>;
     "test reconnecting after following a link does not reload the frame"(): Promise<void>;
+    "test navigating pushing URL state from a frame navigation fires events"(): Promise<void>;
+    "test navigating a frame with a form[method=get] that does not redirect still updates the [src]"(): Promise<void>;
+    "test navigating turbo-frame[data-turbo-action=advance] from within pushes URL state"(): Promise<void>;
+    "test navigating turbo-frame[data-turbo-action=advance] to the same URL clears the [aria-busy] and [data-turbo-preview] state"(): Promise<void>;
+    "test navigating a turbo-frame with an a[data-turbo-action=advance] preserves page state"(): Promise<void>;
+    "test a turbo-frame that has been driven by a[data-turbo-action] can be navigated normally"(): Promise<void>;
+    "test navigating turbo-frame from within with a[data-turbo-action=advance] pushes URL state"(): Promise<void>;
+    "test navigating frame with a[data-turbo-action=advance] pushes URL state"(): Promise<void>;
+    "test navigating frame with form[method=get][data-turbo-action=advance] pushes URL state"(): Promise<void>;
+    "test navigating frame with form[method=get][data-turbo-action=advance] to the same URL clears the [aria-busy] and [data-turbo-preview] state"(): Promise<void>;
+    "test navigating frame with form[method=post][data-turbo-action=advance] pushes URL state"(): Promise<void>;
+    "test navigating frame with form[method=post][data-turbo-action=advance] to the same URL clears the [aria-busy] and [data-turbo-preview] state"(): Promise<void>;
+    "test navigating frame with button[data-turbo-action=advance] pushes URL state"(): Promise<void>;
+    "test navigating back after pushing URL state from a turbo-frame[data-turbo-action=advance] restores the frames previous contents"(): Promise<void>;
+    "test navigating back then forward after pushing URL state from a turbo-frame[data-turbo-action=advance] restores the frames next contents"(): Promise<void>;
     "test turbo:before-fetch-request fires on the frame element"(): Promise<void>;
     "test turbo:before-fetch-response fires on the frame element"(): Promise<void>;
+    withoutChangingEventListenersCount(callback: () => void): Promise<void>;
+    fillInSelector(selector: string, value: string): Promise<void>;
     get frameScriptEvaluationCount(): Promise<number | undefined>;
 }
 declare global {

package/dist/types/tests/functional/navigation_tests.d.ts

@@ -8,8 +8,10 @@ export declare class NavigationTests extends TurboDriveTestCase {
     "test following a same-origin unannotated custom element link"(): Promise<void>;
     "test following a same-origin unannotated form[method=GET]"(): Promise<void>;
     "test following a same-origin data-turbo-action=replace link"(): Promise<void>;
-    "test following a same-origin data-turbo-action=replace form[method=GET]"(): Promise<void>;
-    "test following a same-origin form with button[data-turbo-action=replace]"(): Promise<void>;
+    "test following a same-origin GET form[data-turbo-action=replace]"(): Promise<void>;
+    "test following a same-origin GET form button[data-turbo-action=replace]"(): Promise<void>;
+    "test following a same-origin POST form[data-turbo-action=replace]"(): Promise<void>;
+    "test following a same-origin POST form button[data-turbo-action=replace]"(): Promise<void>;
     "test following a same-origin data-turbo=false link"(): Promise<void>;
     "test following a same-origin unannotated link inside a data-turbo=false container"(): Promise<void>;
     "test following a same-origin data-turbo=true link inside a data-turbo=false container"(): Promise<void>;

package/dist/types/util.d.ts

@@ -10,3 +10,6 @@ export declare function nextMicrotask(): Promise<void>;
 export declare function parseHTMLDocument(html?: string): Document;
 export declare function unindent(strings: TemplateStringsArray, ...values: any[]): string;
 export declare function uuid(): string;
+export declare function getAttribute(attributeName: string, ...elements: (Element | undefined)[]): string | null;
+export declare function markAsBusy(...elements: Element[]): void;
+export declare function clearBusyState(...elements: Element[]): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hotwired/turbo",
-  "version": "7.0.0-rc.5",
+  "version": "7.1.0-rc.2",
   "description": "The speed of a single-page web application without having to write any JavaScript",
   "module": "dist/turbo.es2017-esm.js",
   "main": "dist/turbo.es2017-umd.js",
@@ -20,7 +20,12 @@
     "browser",
     "pushstate"
   ],
-  "author": "javan, packagethief, sstephenson",
+  "author": "Basecamp, LLC",
+  "contributors": [
+    "Jeffrey Hardy <jeff@basecamp.com>",
+    "Javan Makhmali <javan@javan.us>",
+    "Sam Stephenson <sstephenson@gmail.com>"
+  ],
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/hotwired/turbo/issues"