@scayle/storefront-devtools 0.2.0-alpha.1

package/dist/inertia/core/correlator.d.ts

@@ -0,0 +1,91 @@
+import { InertiaPage } from './protocol';
+import { CapturedEvent, RequestRecord } from './types';
+import { NetworkTiming } from './network';
+/**
+ * Correlates individual Inertia events into logical `RequestRecord`s.
+ *
+ * Strategy:
+ * - `before`/`start`/`finish` carry `event.detail.visit` with matching
+ *   properties -> use a visit fingerprint (url + method + only + deferredProps)
+ *   for correlation.
+ * - Other events (navigate, success, etc.) -> correlate via an active visit id.
+ * - Prefetch visits: `inertia:before` fires even for cache hits (no real
+ *   request). Record creation is deferred until `inertia:start` to avoid
+ *   phantom records.
+ *
+ * Inertia creates NEW visit objects for each event dispatch, so identity-based
+ * (WeakMap) correlation does not work.
+ *
+ * @see https://inertiajs.com/events
+ */
+export declare class Correlator {
+    private nextVisitId;
+    private records;
+    private sortedRecords;
+    private maxRecords;
+    private fingerprintMap;
+    private recordByInertiaVisitId;
+    private pendingPrefetch;
+    private activeVisitId;
+    private lastPage;
+    private pendingNetwork;
+    private _evictedCount;
+    constructor(maxRecords?: number);
+    processEvent(event: CapturedEvent): RequestRecord | null;
+    getRequests(): RequestRecord[];
+    getRequest(visitId: number): RequestRecord | undefined;
+    getCurrentPage(): InertiaPage | null;
+    get evictedCount(): number;
+    hasRequestWithUrl(url: string): boolean;
+    processClientVisit(method: 'push' | 'replace', page: InertiaPage, previousPage: InertiaPage): RequestRecord;
+    clear(): void;
+    linkNetworkTiming(timing: NetworkTiming): RequestRecord | null;
+    /**
+     * Attaches request headers captured via `onVisitRequest` to the matching
+     * record. A no-op if no record with this `inertiaVisitId` exists yet: the
+     * interceptor can fire before `inertia:before`'s DOM event listener runs.
+     */
+    attachRequestHeaders(inertiaVisitId: string, headers: Record<string, string>): RequestRecord | null;
+    /**
+     * Attaches response headers and parsed response props captured via
+     * `onVisitResponse` to the matching record. A no-op if no record with this
+     * `inertiaVisitId` exists yet or it has already been evicted.
+     */
+    attachResponseData(inertiaVisitId: string, response: {
+        headers: Record<string, string>;
+        props?: Record<string, unknown>;
+    }): RequestRecord | null;
+    private drainPendingNetwork;
+    private findNetworkMatch;
+    private networkMatchesVisit;
+    private handleBefore;
+    private handleStart;
+    private handleFinish;
+    private handleCancel;
+    private handleNavigate;
+    private handleBeforeUpdate;
+    private handleGenericEvent;
+    private createPrefetchRecord;
+    private visitFingerprint;
+    private pushFingerprint;
+    private removeFromFingerprintMap;
+    private resolveByFingerprint;
+    private resolveByActiveId;
+    private insertRecord;
+    private evictOldest;
+    private removeFromInertiaVisitIdMap;
+    private extractVisit;
+    private extractVisitOptions;
+    private classifyVisitType;
+    private extractUrl;
+    private isDeferredReload;
+    /**
+     * Finds the most recent record a child request can nest under: the latest
+     * non-deferred, non-prefetch record, optionally restricted to one URL.
+     *
+     * @param url - When given, only a record with this exact URL matches.
+     * @returns The matching `visitId`, or undefined when no record qualifies.
+     */
+    private findNestingParentVisitId;
+}
+//# sourceMappingURL=correlator.d.ts.map

package/dist/inertia/core/correlator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlator.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/correlator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAGd,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAQ9C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,cAAc,CAAmC;IAKzD,OAAO,CAAC,sBAAsB,CAAwC;IACtE,OAAO,CAAC,eAAe,CAKR;IACf,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,aAAa,CAAI;gBAEb,UAAU,SAAM;IAI5B,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI;IAoBxD,WAAW,IAAI,aAAa,EAAE;IAI9B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvC,kBAAkB,CAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,WAAW,GACxB,aAAa;IA0BhB,KAAK,IAAI,IAAI;IAYb,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI;IAa9D;;;;OAIG;IACH,oBAAoB,CAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,aAAa,GAAG,IAAI;IASvB;;;;OAIG;IACH,kBAAkB,CAChB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAChC,GACA,aAAa,GAAG,IAAI;IAUvB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,YAAY;IAuEpB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,YAAY;IAyCpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IA6DtB,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,oBAAoB;IAiC5B,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,2BAA2B;IAMnC,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,gBAAgB;IAIxB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;CAQjC"}

package/dist/inertia/core/diagnostics.d.ts

@@ -0,0 +1,10 @@
+import { RequestRecord, Diagnostic } from './types';
+/**
+ * Runs every diagnostic rule against a request record and collects the hits.
+ * Called by the correlator whenever a record gains new information.
+ *
+ * @param req - The request record to inspect.
+ * @returns The diagnostics that matched, in rule order. Empty when none apply.
+ */
+export declare function computeDiagnostics(req: RequestRecord): Diagnostic[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/inertia/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAsHxD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE,CASnE"}

package/dist/inertia/core/diff.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Computes a structural diff between two values.
+ * Returns a tree of `DiffNode` entries describing what changed.
+ */
+/** How a single key changed between the old and new value. */
+export type DiffType = 'added' | 'removed' | 'changed' | 'unchanged' | 'nested';
+/** One node in a structural diff tree, keyed by object property or array index. */
+export interface DiffNode {
+    type: DiffType;
+    key: string;
+    oldValue?: unknown;
+    newValue?: unknown;
+    children?: DiffNode[];
+}
+/**
+ * Diffs two objects (typically Inertia page props) into a tree of changes,
+ * recursing into plain objects and arrays for element-level detail.
+ *
+ * @param oldObj - The previous object, or undefined when the prop is new.
+ * @param newObj - The current object, or undefined when the prop was removed.
+ * @returns One {@link DiffNode} per top-level key, with nested children for
+ *   recursed objects and arrays.
+ */
+export declare function diffProps(oldObj: Record<string, unknown> | undefined, newObj: Record<string, unknown> | undefined): DiffNode[];
+/**
+ * Deeply compares two values, tolerant of cycles.
+ *
+ * @param a - First value.
+ * @param b - Second value.
+ * @returns True when the values are structurally equal.
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/inertia/core/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/diff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE/E,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,QAAQ,EAAE,CA6CZ;AA0DD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/dist/inertia/core/events-tab.d.ts

@@ -0,0 +1,20 @@
+import { CapturedEvent } from '../core/types';
+/** One row in the lifecycle timeline. */
+export interface LifecycleStep {
+    /** Event name with the `inertia:` prefix stripped. */
+    name: string;
+    /** Offset from the first event, formatted like `+12ms`. */
+    offset: string;
+    /** Terminal classification, when this step ends the visit. */
+    terminal?: 'success' | 'error' | 'cancelled';
+}
+/**
+ * Builds an ordered lifecycle timeline from a request's captured events.
+ * Keeps only the lifecycle events (dropping progress, flash, prefetch noise)
+ * and stamps each with its offset from the first captured event.
+ *
+ * @param events - The request's captured events, in capture order.
+ * @returns Ordered lifecycle steps. Empty when there are no events.
+ */
+export declare function computeLifecycle(events: CapturedEvent[]): LifecycleStep[];
+//# sourceMappingURL=events-tab.d.ts.map

package/dist/inertia/core/events-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-tab.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/events-tab.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;CAC7C;AA2BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CA6BzE"}

package/dist/inertia/core/feature-info.d.ts

@@ -0,0 +1,14 @@
+/** Human description and documentation link for an Inertia feature badge. */
+export interface FeatureInfo {
+    description: string;
+    docsUrl: string;
+}
+/**
+ * Looks up the description and documentation link for an Inertia feature type.
+ * Used by the feature badges and the markdown exporter.
+ *
+ * @param type - The `ActiveFeature['type']` value, for example `partial`.
+ * @returns The matching {@link FeatureInfo}, or `undefined` for unknown types.
+ */
+export declare function getFeatureInfo(type: string): FeatureInfo | undefined;
+//# sourceMappingURL=feature-info.d.ts.map

package/dist/inertia/core/feature-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-info.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/feature-info.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAyDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE"}

package/dist/inertia/core/features.d.ts

@@ -0,0 +1,27 @@
+import { InertiaPage } from './protocol';
+import { ActiveFeature, RequestRecord } from './types';
+/**
+ * Extracts page-level Inertia features from a page object. These features
+ * depend only on page properties (deferred props, merge strategies, encryption,
+ * flash, etc.) and do not require a `RequestRecord`.
+ *
+ * @param page - The Inertia page object to inspect.
+ * @returns The features present on the page, in detection order.
+ * @see https://inertiajs.com/deferred-props
+ * @see https://inertiajs.com/merging-props
+ * @see https://inertiajs.com/history-encryption
+ */
+export declare function extractPageFeatures(page: InertiaPage): ActiveFeature[];
+/**
+ * Extracts active Inertia features from a request record and its page object.
+ * Combines request-specific features (partial, prefetch, cached) with
+ * page-level features from {@link extractPageFeatures}.
+ *
+ * @param record - The request record, used for partial/prefetch/cached signals.
+ * @param page - The page object resolved for the request.
+ * @returns The combined feature list for the request.
+ * @see https://inertiajs.com/partial-reloads
+ * @see https://inertiajs.com/prefetching
+ */
+export declare function extractFeatures(record: RequestRecord, page: InertiaPage): ActiveFeature[];
+//# sourceMappingURL=features.d.ts.map

package/dist/inertia/core/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAW3D;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,EAAE,CAiFtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAChB,aAAa,EAAE,CAmBjB"}

package/dist/inertia/core/history-capture.d.ts

@@ -0,0 +1,15 @@
+import { DevToolsStore } from './store';
+import { StopFunction } from './types';
+/**
+ * Monkey-patches `history.pushState` and `history.replaceState` to detect
+ * client-side visits that bypass the normal Inertia event lifecycle
+ * (`router.push`, `router.replace`, `router.replaceProp`, and so on). A
+ * pending-server-visit counter suppresses double-counting of server visits,
+ * and encrypted history (an ArrayBuffer page) falls back to a deferred check
+ * against the store's current page.
+ *
+ * @param store - The devtools store that receives detected client visits.
+ * @returns A function that restores the original history methods.
+ */
+export declare function startHistoryCapture(store: DevToolsStore): StopFunction;
+//# sourceMappingURL=history-capture.d.ts.map

package/dist/inertia/core/history-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-capture.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/history-capture.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAkD3C;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAsHtE"}

package/dist/inertia/core/interceptors.d.ts

@@ -0,0 +1,69 @@
+import { DevToolsStore } from './store';
+/** The subset of `@inertiajs/core`'s `@internal` interceptor registry this module relies on. */
+export interface InertiaInterceptorRegistry {
+    onVisitRequest: (handler: (visit: {
+        id: string;
+    }, config: {
+        headers?: Record<string, unknown>;
+    }) => unknown) => () => void;
+    onVisitResponse: (handler: (visit: {
+        id: string;
+    }, response: {
+        data: unknown;
+        headers?: Record<string, string>;
+    }) => unknown) => () => void;
+}
+declare global {
+    interface Window {
+        __inertia_interceptors__?: InertiaInterceptorRegistry;
+    }
+}
+/**
+ * Normalizes a header value record to lowercase keys and string values.
+ * `HttpRequestConfig.headers` types values as `unknown`, but Inertia only
+ * ever sets strings on it in practice.
+ *
+ * @param headers - The raw header record, keys in whatever case the caller used.
+ * @returns A lowercased, stringified copy. Empty when `headers` is absent.
+ */
+export declare function normalizeHeaders(headers: Record<string, unknown> | undefined): Record<string, string>;
+/**
+ * Extracts the top-level `props` from an Inertia response body.
+ *
+ * `HttpResponse.data` is documented as the raw response string, but by the
+ * time `onVisitResponse` fires, `Response#getPageResponse()` has already
+ * parsed it in place into the page object (verified against the real running
+ * response: `data` arrives as `{ component, props, url, ... }`, not a JSON
+ * string). This accepts either shape, so it keeps working if a future
+ * `@inertiajs/core` version calls the interceptor earlier in that pipeline.
+ *
+ * @param data - The response body, already-parsed or a raw JSON string.
+ * @returns The page's `props`, or `undefined` when the body isn't page-shaped
+ *   (a non-Inertia response, or a parse failure).
+ */
+export declare function extractResponseProps(data: unknown): Record<string, unknown> | undefined;
+/**
+ * Subscribes to Inertia's `@internal` `window.__inertia_interceptors__`
+ * registry to capture the real request/response headers and raw response
+ * body per visit, none of which the public DOM CustomEvents expose. Exposed
+ * by `createInertiaApp`'s default `dev: import.meta.env.DEV` option, so it is
+ * absent (and this becomes a no-op) in a production build or if a host app
+ * disables it.
+ *
+ * The registry doesn't exist yet when this module runs: the devtools client
+ * is injected at the *top* of the app's own entry module (`inject.ts`), so it
+ * always executes before that entry's own `createInertiaApp(...)` call, which
+ * is what creates `window.__inertia_interceptors__` in the first place. This
+ * polls briefly until the app's own setup catches up.
+ *
+ * This registry is `@internal` and undocumented: it may be renamed or
+ * removed in a future `@inertiajs/core` release without notice. Every access
+ * is guarded so its absence never breaks the devtools, let alone the host
+ * app — a version bump just silently loses header/response capture again.
+ *
+ * @param store - The devtools store that receives captured headers/body.
+ * @returns A teardown function that stops polling and unsubscribes both
+ *   handlers, whichever state capture is currently in.
+ */
+export declare function startInterceptorCapture(store: DevToolsStore): () => void;
+//# sourceMappingURL=interceptors.d.ts.map

package/dist/inertia/core/interceptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/interceptors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAI5C,gGAAgG;AAChG,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,CACd,OAAO,EAAE,CACP,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACrB,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAC1C,OAAO,KACT,MAAM,IAAI,CAAA;IACf,eAAe,EAAE,CACf,OAAO,EAAE,CACP,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACrB,QAAQ,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAC1D,OAAO,KACT,MAAM,IAAI,CAAA;CAChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,wBAAwB,CAAC,EAAE,0BAA0B,CAAA;KACtD;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAsBrC;AAoDD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,IAAI,CA0BxE"}

package/dist/inertia/core/markdown.d.ts

@@ -0,0 +1,10 @@
+import { RequestRecord } from './types';
+/**
+ * Formats a request record as markdown for pasting into AI chats, issues, or
+ * chat. Includes the raw page JSON so the exact prop values are inspectable.
+ *
+ * @param request - The request record to format.
+ * @returns A markdown document with header, features, error, and page sections.
+ */
+export declare function requestToMarkdown(request: RequestRecord): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/inertia/core/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AA2D5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAkChE"}

package/dist/inertia/core/network.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Network timing capture using `PerformanceObserver`.
+ *
+ * Observes Resource Timing entries for Inertia requests (matched by URL) instead
+ * of monkey-patching XHR/fetch. This is non-invasive and avoids conflicts with
+ * other libraries or browser extensions.
+ */
+/** Resource Timing data for a single Inertia request. */
+export interface NetworkTiming {
+    url: string;
+    /** Wall-clock request duration in milliseconds. */
+    duration: number;
+    /** Request start, on the `performance.now()` timeline (`startTime`). */
+    startedAt: number;
+    /** Request end, `startTime + duration`. */
+    finishedAt: number;
+    /** Bytes transferred over the wire. `0` when served from cache. */
+    transferSize?: number;
+}
+/** Receives one {@link NetworkTiming} per matched Inertia resource entry. */
+export type NetworkTimingCallback = (timing: NetworkTiming) => void;
+/**
+ * Starts observing Resource Timing entries for Inertia requests via
+ * `PerformanceObserver`. Non-invasive: it reads the browser's own timing data
+ * instead of patching `XMLHttpRequest` or `fetch`.
+ *
+ * @param isInertiaUrl - Predicate that decides whether a resource URL belongs
+ *   to an Inertia request.
+ * @param onTiming - Called once per matched resource entry.
+ * @returns A teardown function that disconnects the observer. A no-op when
+ *   `PerformanceObserver` is unavailable.
+ */
+export declare function startNetworkCapture(isInertiaUrl: (url: string) => boolean, onTiming: NetworkTimingCallback): () => void;
+//# sourceMappingURL=network.d.ts.map

package/dist/inertia/core/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/network.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAA;AAEnE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,EACtC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,IAAI,CAqCZ"}

package/dist/inertia/core/protocol.d.ts

@@ -0,0 +1,38 @@
+import { Page } from '@inertiajs/core';
+/**
+ * Relaxed version of `@inertiajs/core`'s `Page` type. Uses looser field types
+ * for forward compatibility across Inertia versions and to simplify test mocks
+ * (core's `Page` requires all fields). Field names track the `Page` interface
+ * from `@inertiajs/core` 3.x.
+ *
+ * @see https://inertiajs.com/the-protocol#the-page-object
+ * @see https://github.com/inertiajs/inertia/blob/master/packages/core/types/types.d.ts
+ */
+export type InertiaPage = Pick<Page, 'component' | 'url' | 'version' | 'clearHistory' | 'encryptHistory'> & {
+    props: Record<string, unknown>;
+    deferredProps?: Record<string, string[]>;
+    initialDeferredProps?: Record<string, string[]>;
+    mergeProps?: string[];
+    prependProps?: string[];
+    deepMergeProps?: string[];
+    matchPropsOn?: string[];
+    scrollProps?: Record<string, unknown>;
+    flash: Record<string, unknown>;
+    onceProps?: Record<string, {
+        prop: string;
+        expiresAt?: number | null;
+    }>;
+    rememberedState?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+/**
+ * Every Inertia DOM event name the capture layer listens for. These are the
+ * events from the Inertia 3.x core `GlobalEventsMap`.
+ *
+ * @see https://inertiajs.com/events
+ * @see https://github.com/inertiajs/inertia/blob/master/packages/core/types/events.d.ts
+ */
+export declare const INERTIA_DOM_EVENTS: readonly ["inertia:before", "inertia:start", "inertia:progress", "inertia:success", "inertia:error", "inertia:httpException", "inertia:networkError", "inertia:finish", "inertia:cancel", "inertia:beforeUpdate", "inertia:navigate", "inertia:flash", "inertia:prefetching", "inertia:prefetched"];
+/** Union of the Inertia DOM event names in {@link INERTIA_DOM_EVENTS}. */
+export type InertiaEventName = (typeof INERTIA_DOM_EVENTS)[number];
+//# sourceMappingURL=protocol.d.ts.map

package/dist/inertia/core/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,IAAI,EACJ,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,CACpE,GAAG;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IAEvE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,qSAerB,CAAA;AAEV,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/inertia/core/request-tree.d.ts

@@ -0,0 +1,18 @@
+import { RequestRecord } from '../core/types';
+/** A request row plus its nesting depth for the deferred parent/child view. */
+export interface TreeRow {
+    record: RequestRecord;
+    depth: number;
+}
+/**
+ * Groups a flat request list into a one-level parent/child render list.
+ * A record whose `parentVisitId` matches another record in the list nests
+ * under that parent at depth 1, placed after it. Records with no parent, or
+ * whose parent is not in the list (orphans), render at depth 0. Order is
+ * otherwise preserved.
+ *
+ * @param records - The flat request list, in display order.
+ * @returns Ordered rows with a `depth` of 0 (root) or 1 (deferred child).
+ */
+export declare function buildTree(records: RequestRecord[]): TreeRow[];
+//# sourceMappingURL=request-tree.d.ts.map

package/dist/inertia/core/request-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-tree.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/request-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAElD,+EAA+E;AAC/E,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,aAAa,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAI7D"}

package/dist/inertia/core/response.d.ts

@@ -0,0 +1,39 @@
+import { RequestRecord } from './types';
+/** How a response prop key actually arrived on the wire, for the Response view. */
+export type ResponseArrivalKind = 'full' | 'partial' | 'deferred' | 'merged' | 'prepended' | 'deep-merged';
+/** One prop key the response body actually included, tagged by arrival kind. */
+export interface ResponseEntry {
+    key: string;
+    value: unknown;
+    kind: ResponseArrivalKind;
+}
+/** A key the request's `only` list named but the response body did not include. */
+export interface MissingOnlyEntry {
+    key: string;
+}
+/** The Response view's full classification of one request's response. */
+export interface ResponseBreakdown {
+    entries: ResponseEntry[];
+    missingOnly: MissingOnlyEntry[];
+    /** Count of props carried over from the previous page, not part of this response. */
+    carriedOverCount: number;
+}
+/**
+ * Classifies a request's actual response body into what the Response view
+ * shows: each key the response contained (tagged by how it arrived), which
+ * `only`-requested keys never showed up, and how many props were carried
+ * over from the previous page untouched by this response.
+ *
+ * Unlike a before/after diff, this never looks at the previous page's props
+ * for its main output: `record.responseProps` is the raw wire payload, so a
+ * key it doesn't contain genuinely wasn't sent for this request, whether or
+ * not the client's merged page still shows it.
+ *
+ * @param record - The request record. Uses `responseProps` (the parsed wire
+ *   body), falling back to nothing if the interceptor never captured it.
+ * @returns The classified breakdown, or `null` if no response body was
+ *   captured for this request (for example a cancelled visit, or Inertia's
+ *   `@internal` interceptor registry wasn't available).
+ */
+export declare function classifyResponse(record: RequestRecord): ResponseBreakdown | null;
+//# sourceMappingURL=response.d.ts.map

package/dist/inertia/core/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/response.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAC7B,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAA;AAE1E,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,mBAAmB,CAAA;CAC1B;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,qFAAqF;IACrF,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAyBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,GACpB,iBAAiB,GAAG,IAAI,CAyB1B"}

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

@@ -0,0 +1,18 @@
+import { RequestRecord, SessionSnapshot, SessionRequestSummary } from './types';
+/**
+ * Converts a full `RequestRecord` to a compact summary.
+ */
+export declare function summarizeRequest(req: RequestRecord): SessionRequestSummary;
+/**
+ * Saves the current requests to sessionStorage as compact summaries.
+ */
+export declare function saveSession(requests: RequestRecord[]): void;
+/**
+ * Loads the previous session from sessionStorage; returns null if expired or missing.
+ */
+export declare function loadSession(): SessionSnapshot | null;
+/**
+ * Clears the persisted session.
+ */
+export declare function clearSession(): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/inertia/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAMhB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CAQ1E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CAK3D;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,eAAe,GAAG,IAAI,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/inertia/core/store.d.ts

@@ -0,0 +1,40 @@
+import { InertiaPage, InertiaEventName } from './protocol';
+import { RequestRecord, DevToolsState, SessionRequestSummary } from './types';
+import { NetworkTiming } from './network';
+type Subscriber = (state: DevToolsState) => void;
+/**
+ * Central state store for the devtools. Framework-agnostic: exposes a
+ * `subscribe()` pattern that any UI can consume.
+ */
+export declare class DevToolsStore {
+    private correlator;
+    private subscribers;
+    private nextEventId;
+    private tick;
+    private _paused;
+    private previousSession;
+    private saveTimer;
+    constructor();
+    get requests(): RequestRecord[];
+    get currentPage(): InertiaPage | null;
+    getRequest(visitId: number): RequestRecord | undefined;
+    isInertiaRequestUrl(url: string): boolean;
+    get evictedCount(): number;
+    get paused(): boolean;
+    get previousSessionRequests(): SessionRequestSummary[];
+    getState(): DevToolsState;
+    captureEvent(name: InertiaEventName, event: Event): void;
+    captureNetworkTiming(timing: NetworkTiming): void;
+    captureInterceptedRequest(inertiaVisitId: string, headers: Record<string, string>): void;
+    captureInterceptedResponse(inertiaVisitId: string, data: {
+        headers: Record<string, string>;
+        props?: Record<string, unknown>;
+    }): void;
+    captureClientVisit(method: 'push' | 'replace', page: InertiaPage, previousPage: InertiaPage): void;
+    subscribe(fn: Subscriber): () => void;
+    setPaused(value: boolean): void;
+    clear(): void;
+    private notify;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

package/dist/inertia/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/inertia/core/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAEV,aAAa,EACb,aAAa,EACb,qBAAqB,EACtB,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAI9C,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;AAEhD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,SAAS,CAA2C;;IAO5D,IAAI,QAAQ,IAAI,aAAa,EAAE,CAO9B;IAED,IAAI,WAAW,IAAI,WAAW,GAAG,IAAI,CAEpC;IAED,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,uBAAuB,IAAI,qBAAqB,EAAE,CAErD;IAED,QAAQ,IAAI,aAAa;IAUzB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAkBxD,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAQjD,yBAAyB,CACvB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI;IAQP,0BAA0B,CACxB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACzE,IAAI;IAQP,kBAAkB,CAChB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,WAAW,GACxB,IAAI;IAQP,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,MAAM,IAAI;IAOrC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK/B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,MAAM;CAaf"}