@orieljs/framework 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/{chunk-SBZQ6L3Z.js → chunk-WNJP46B7.js}

@@ -8,8 +8,9 @@ import {
   Str,
   currentContainer,
   facade,
+  fileType_exports,
   inject
-} from "./chunk-DCI2T7WJ.js";
+} from "./chunk-PM5YTG57.js";
 import {
   Application,
   AuthFactory,
@@ -32,6 +33,7 @@ import {
   MailManager,
   MiddlewareCallbacks,
   NotificationDispatcher,
+  PaginationState,
   PipelineFactory,
   QueueManager,
   Redirector,
@@ -43,7 +45,7 @@ import {
   ValidationFactory,
   ViewFactory,
   token
-} from "./chunk-WSGWYXAO.js";
+} from "./chunk-BSQKOLSK.js";
 
 // ../Config/dist/index.js
 import { existsSync, readFileSync } from "fs";
@@ -490,7 +492,7 @@ var Application2 = class _Application extends Container {
     this.scoped(Vite, () => new Vite(this));
   }
   base;
-  version = "0.1.0-alpha.4";
+  version = "0.1.0-alpha.5";
   providers = [];
   bootingCallbacks = [];
   bootedCallbacks = [];
@@ -885,20 +887,60 @@ function mimeFromExtension(pathOrExtension) {
 function extensionFromMime(type) {
   return EXTENSIONS[type.split(";")[0].trim().toLowerCase()];
 }
-var FormUploadedFile = class {
-  constructor(file) {
+var NEVER_CLAIMED = /* @__PURE__ */ new Set([
+  ...fileType_exports.BINARY_AND_MARKUP_TYPES.flatMap(({ extensions }) => extensions),
+  "jpe",
+  "svgz",
+  "xhtml",
+  "xht",
+  "shtml",
+  "xsl",
+  "xslt",
+  "mht",
+  "mhtml",
+  "js",
+  "mjs",
+  "rss",
+  "atom",
+  "rdf",
+  "mathml",
+  "mml",
+  "xul"
+]);
+var PLAIN_EXTENSION = /^[a-z0-9]+$/;
+var FormUploadedFile = class _FormUploadedFile {
+  constructor(file, detected) {
     this.file = file;
+    this.detected = detected;
     this.clientName = file.name ?? "";
     this.mimeType = file.type === "" ? "application/octet-stream" : file.type;
     this.size = file.size;
   }
   file;
+  detected;
   clientName;
   mimeType;
   size;
-  /** Guessed from the MIME type, falling back to the client's extension (Laravel's extension()). */
+  /**
+   * Reads the leading bytes first, so extension(), hashName() and store() name the file by its content. The request
+   * builds its uploads this way.
+   */
+  static async fromFile(file) {
+    return new _FormUploadedFile(file, fileType_exports.detectFileType(new Uint8Array(await file.slice(0, fileType_exports.SNIFF_BYTES).arrayBuffer())));
+  }
+  /**
+   * Laravel's extension(): the type the bytes show (guessExtension()), when they were read and match a known format.
+   * Text and bytes no format matches keep the client's claim (its MIME type, else its file name) when it is a plain
+   * extension, unless it names a format the bytes would have shown or one a browser renders or runs: otherwise 'txt'
+   * for text, '' for the rest. Unread (built directly), the client's claim when it is a plain extension, else ''.
+   */
   extension() {
-    return extensionFromMime(this.mimeType) ?? this.clientExtension();
+    const claimed = extensionFromMime(this.mimeType) ?? this.clientExtension();
+    const detected = this.detected;
+    if (detected === void 0) return PLAIN_EXTENSION.test(claimed) ? claimed : "";
+    if (detected !== fileType_exports.TEXT && detected.extensions.length > 0) return detected.extensions[0];
+    if (PLAIN_EXTENSION.test(claimed) && !NEVER_CLAIMED.has(claimed)) return claimed;
+    return detected === fileType_exports.TEXT ? "txt" : "";
   }
   clientExtension() {
     const dot = this.clientName.lastIndexOf(".");
@@ -1078,7 +1120,7 @@ var IncomingRequest = class {
             this.#content = new TextDecoder().decode(bytes);
             this.#body = fromEntries(new URLSearchParams(this.#content).entries());
           } else {
-            this.#parseForm(await new Response(bytes, { headers: { "content-type": this.raw.headers.get("content-type") ?? "" } }).formData());
+            await this.#parseForm(await new Response(bytes, { headers: { "content-type": this.raw.headers.get("content-type") ?? "" } }).formData());
           }
         } catch {
         }
@@ -1103,12 +1145,12 @@ var IncomingRequest = class {
     if (Array.isArray(parsed)) return sanitize({ ...parsed });
     return isPlainObject(parsed) ? sanitize(parsed) : {};
   }
-  #parseForm(form) {
+  async #parseForm(form) {
     const fields = [];
     const files = [];
     for (const [name, value] of form.entries()) {
       if (typeof value === "string") fields.push([name, value]);
-      else if (!((value.name ?? "") === "" && value.size === 0)) files.push([name, new FormUploadedFile(value)]);
+      else if (!((value.name ?? "") === "" && value.size === 0)) files.push([name, await FormUploadedFile.fromFile(value)]);
     }
     this.#body = fromEntries(fields);
     this.#files = fromEntries(files);
@@ -2458,12 +2500,13 @@ var HttpServiceProvider = class extends ServiceProvider {
 // ../Live/dist/index.js
 import { AssertionError } from "assert";
 import { isDeepStrictEqual } from "util";
-import { AsyncLocalStorage } from "async_hooks";
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
 import { randomBytes as randomBytes2 } from "crypto";
 import { createHmac, timingSafeEqual } from "crypto";
 import { existsSync as existsSync5, readdirSync as readdirSync2 } from "fs";
 import { join as join5, relative as relative2, sep as sep2 } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
+import { AsyncLocalStorage } from "async_hooks";
 import { existsSync as existsSync22 } from "fs";
 import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
 import { dirname as dirname2, join as join23, relative as relative22, sep as sep22 } from "path";
@@ -2673,6 +2716,20 @@ var Component = class {
     return inject(LiveManager).page(this);
   }
 };
+function trackFlash(session, { saved = true } = {}) {
+  if (session === void 0) return () => void 0;
+  const before = new Set(session.get("_flash.new", []));
+  return (redirected) => {
+    if (redirected) return;
+    const flashed = session.get("_flash.new", []);
+    const fresh = flashed.filter((key) => !before.has(key));
+    if (fresh.length === 0) return;
+    session.put("_flash.new", flashed.filter((key) => before.has(key)));
+    if (!saved) return session.forget(...fresh);
+    const old = session.get("_flash.old", []);
+    session.put("_flash.old", [...old, ...fresh.filter((key) => !old.includes(key))]);
+  };
+}
 var LiveError = class extends Error {
   name = "LiveError";
   kind = "Server";
@@ -2773,6 +2830,15 @@ function requestScope2() {
   const container = currentContainer() ?? Container.getInstance();
   return container?.bound(TestRequestScope) === true ? container.make(TestRequestScope) : (run) => run();
 }
+function currentSession() {
+  const container = currentContainer();
+  if (container?.bound(Session) !== true) return void 0;
+  try {
+    return container.make(Session);
+  } catch {
+    return void 0;
+  }
+}
 var Testable = class _Testable {
   constructor(manager, scope, result) {
     this.manager = manager;
@@ -2827,7 +2893,12 @@ var Testable = class _Testable {
     return this.#update({}, [{ method: "$refresh", params: [] }]);
   }
   async #update(updates, calls) {
-    const result = await this.scope(() => this.manager.updateComponent(this.#snapshot, updates, calls));
+    const result = await this.scope(async () => {
+      const flashed = trackFlash(currentSession(), { saved: false });
+      const updated = await this.manager.updateComponent(this.#snapshot, updates, calls);
+      flashed(updated.effects.redirect !== void 0);
+      return updated;
+    });
     this.#snapshot = JSON.stringify(result.snapshot);
     if (result.html !== void 0) this.#html = result.html;
     this.#effects = result.effects;
@@ -2958,10 +3029,11 @@ async function discover(directory) {
   }
   return found;
 }
-var PERSISTENT_MIDDLEWARE = ["auth", "verified", "guest"];
+var PERSISTENT_MIDDLEWARE = ["auth", "verified", "guest", "can"];
+var ROUTER_METHODS = ["getRoutesByMatchOrder", "getPatterns", "getPatternVersion", "getMiddleware", "getMiddlewareGroups", "substituteBindings"];
 function canMatch(router) {
   const methods = router;
-  return ["getRoutesByMatchOrder", "getPatterns", "getPatternVersion", "getMiddleware", "getMiddlewareGroups"].every((name) => typeof methods[name] === "function");
+  return ROUTER_METHODS.every((name) => typeof methods[name] === "function");
 }
 function isMatchingRoute(route2) {
   const candidate = route2;
@@ -2990,7 +3062,7 @@ function expand(references, aliases, groups, out = [], visiting = /* @__PURE__ *
   }
   return out;
 }
-function persistentMiddleware(router, persistent, method, path) {
+function persistentPass(router, persistent, method, path) {
   if (!canMatch(router)) throw new LiveError("Live re-applies the page route's middleware to updates, which needs Oriel's router.");
   const routes = router.getRoutesByMatchOrder();
   if (!Array.isArray(routes) || !routes.every(isMatchingRoute)) throw new LiveError("Live re-applies the page route's middleware to updates, which needs Oriel's routes.");
@@ -2998,36 +3070,80 @@ function persistentMiddleware(router, persistent, method, path) {
   const target2 = routePath(path);
   const patterns = router.getPatterns();
   const version = router.getPatternVersion();
-  const route2 = routes.find((candidate) => candidate.methods.includes(verb) && candidate.match(target2, patterns, version) !== void 0);
-  if (route2 === void 0) return [];
+  let matched;
+  for (const candidate of routes) {
+    const values2 = candidate.methods.includes(verb) ? candidate.match(target2, patterns, version) : void 0;
+    if (values2 !== void 0) {
+      matched = { route: candidate, values: values2 };
+      break;
+    }
+  }
+  if (matched === void 0) return void 0;
+  const { route: route2, values } = matched;
   const aliases = router.getMiddleware();
   const groups = router.getMiddlewareGroups();
   const wanted = new Set(persistent.flatMap((name) => Object.hasOwn(aliases, name) ? [aliases[name]] : []));
   const excluded = new Set(expand(route2.excludedMiddleware(), aliases, groups).map((entry) => entry.cls));
   const ids = /* @__PURE__ */ new Map();
   const seen = /* @__PURE__ */ new Set();
-  return expand(route2.gatherMiddleware(), aliases, groups).filter((entry) => {
+  const middleware = expand(route2.gatherMiddleware(), aliases, groups).filter((entry) => {
     if (!ids.has(entry.cls)) ids.set(entry.cls, ids.size);
     const key = `${ids.get(entry.cls)}:${entry.parameters.join(",")}`;
     if (!wanted.has(entry.cls) || excluded.has(entry.cls) || seen.has(key)) return false;
     seen.add(key);
     return true;
   });
+  const early = new Set(expand(["web", "api"], aliases, groups).map((entry) => entry.cls));
+  for (const name of ["auth", "guest"]) if (Object.hasOwn(aliases, name)) early.add(aliases[name]);
+  const before = middleware.filter((entry) => early.has(entry.cls));
+  const after = middleware.filter((entry) => !early.has(entry.cls));
+  return { router, route: route2, values, middleware: [...before, ...after], at: before.length };
+}
+function persistentMiddleware(router, persistent, method, path) {
+  return [...persistentPass(router, persistent, method, path)?.middleware ?? []];
+}
+function currentRoute(container) {
+  if (!container.bound(CurrentRoute)) return void 0;
+  try {
+    return container.make(CurrentRoute);
+  } catch {
+    return void 0;
+  }
 }
-async function throughMiddleware(container, request2, middleware, destination) {
+async function throughMiddleware(container, request2, pass, destination) {
+  const original = currentRoute(container);
+  const page = { route: pass.route, parameters: { ...pass.values }, middleware: [] };
+  let swapped = false;
+  const show = () => {
+    container.instance(CurrentRoute, page);
+    swapped = true;
+  };
+  const restore = () => {
+    if (!swapped) return;
+    if (original === void 0) container.forgetInstance(CurrentRoute);
+    else container.instance(CurrentRoute, original);
+    swapped = false;
+  };
   let ran;
   const run = async (index) => {
-    if (index === middleware.length) {
+    if (index === pass.at) Object.assign(page.parameters, await pass.router.substituteBindings(pass.route, pass.values, container));
+    if (index === pass.middleware.length) {
+      restore();
       ran = { result: await destination() };
       return new Response(null, { status: 204 });
     }
-    const { cls, parameters } = middleware[index];
+    const { cls, parameters } = pass.middleware[index];
     const instance = container.make(cls);
     const next = () => run(index + 1);
     return instance.handle(request2, next, ...parameters);
   };
-  const response2 = await run(0);
-  return ran ? ran.result : response2;
+  show();
+  try {
+    const response2 = await run(0);
+    return ran ? ran.result : response2;
+  } finally {
+    restore();
+  }
 }
 function isModel(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -3167,8 +3283,64 @@ function isUpdatable(instance, path) {
   }
   return !isModel(node) && !(node instanceof Collection);
 }
-var renderContext = new AsyncLocalStorage();
-var pageRequest = new AsyncLocalStorage();
+var PAGINATED = /* @__PURE__ */ Symbol.for("oriel:live.pagination");
+function toPage(value) {
+  const page = typeof value === "number" ? value : typeof value === "string" && value.trim() !== "" ? Number(value) : Number.NaN;
+  return Number.isFinite(page) && page >= 1 ? Math.min(Math.floor(page), Number.MAX_SAFE_INTEGER) : 1;
+}
+async function hook(instance, name, ...args) {
+  const method = instance[name];
+  if (typeof method === "function") await method.apply(instance, args);
+}
+function WithPagination(Base) {
+  class WithPaginationMixin extends Base {
+    page = 1;
+    nextPage() {
+      return this.setPage(toPage(this.page) + 1);
+    }
+    previousPage() {
+      return this.setPage(Math.max(toPage(this.page) - 1, 1));
+    }
+    gotoPage(page) {
+      return this.setPage(page);
+    }
+    resetPage() {
+      return this.setPage(1);
+    }
+    async setPage(page) {
+      const next = toPage(page);
+      await hook(this, "updatingPage", next);
+      this.page = next;
+      await hook(this, "updatedPage", next);
+    }
+  }
+  Object.defineProperty(WithPaginationMixin.prototype, PAGINATED, { value: true });
+  return WithPaginationMixin;
+}
+function isPaginated(component) {
+  return component[PAGINATED] === true;
+}
+var rendering = new AsyncLocalStorage();
+function renderPaginated(component, url2, run) {
+  return rendering.run(isPaginated(component) ? { component, url: url2 } : void 0, run);
+}
+function outsidePagination(run) {
+  return rendering.run(void 0, run);
+}
+var livePaginationState = {
+  currentPage(pageName) {
+    const current = rendering.getStore();
+    if (current === void 0 || pageName !== "page") return void 0;
+    const page = toPage(current.component.page);
+    current.component.page = page;
+    return page;
+  },
+  currentPath() {
+    return rendering.getStore()?.url;
+  }
+};
+var renderContext = new AsyncLocalStorage2();
+var pageRequest = new AsyncLocalStorage2();
 function optional(container, token2) {
   if (!container.bound(token2)) return void 0;
   try {
@@ -3181,7 +3353,7 @@ var isRecord = (value) => typeof value === "object" && value !== null && !Array.
 function setOwn(object, key, value) {
   Object.defineProperty(object, key, { value, enumerable: true, writable: true, configurable: true });
 }
-async function hook(instance, name, ...args) {
+async function hook2(instance, name, ...args) {
   const method = instance[name];
   if (typeof method === "function") await method.apply(instance, args);
 }
@@ -3232,7 +3404,7 @@ var LiveComponentManager = class {
       setOwn(context.children, childKey, existing);
       return `<${existing[0]} o:id="${escapeAttribute2(existing[1])}"></${existing[0]}>`;
     }
-    const result = await this.mountComponent(component, params);
+    const result = await outsidePagination(() => this.mountComponent(component, params));
     setOwn(context.children, childKey, [result.tag, result.snapshot.memo.id]);
     return result.html;
   }
@@ -3244,14 +3416,14 @@ var LiveComponentManager = class {
     const state = stateOf(instance);
     state.id = randomBytes2(15).toString("base64url");
     state.name = name;
-    await hook(instance, "boot");
+    await hook2(instance, "boot");
     for (const [property, value] of Object.entries(params)) {
       if (Object.hasOwn(instance, property)) instance[property] = value;
     }
     this.prepareComputed(instance);
-    await hook(instance, "mount", params);
     const request2 = optional(this.container(), HttpRequest);
     const page = pageRequest.getStore() ?? { path: request2?.path() ?? "", method: request2?.method() ?? "GET" };
+    await renderPaginated(instance, this.pageUrl(page.path), () => hook2(instance, "mount", params));
     const memo = { id: state.id, name, path: page.path, method: page.method, children: {}, errors: {} };
     const { html, tag } = await this.render(instance, memo, {});
     const effects = this.effects(instance);
@@ -3279,22 +3451,24 @@ var LiveComponentManager = class {
     state.id = snapshot.memo.id;
     state.name = snapshot.memo.name;
     state.errors = { ...snapshot.memo.errors };
-    await hook(instance, "boot");
+    await hook2(instance, "boot");
     const registry = this.registry();
     for (const [property, value] of Object.entries(snapshot.data)) {
       Object.defineProperty(instance, property, { value: await hydrate(value, registry), enumerable: true, writable: true, configurable: true });
     }
     this.prepareComputed(instance);
-    await hook(instance, "hydrate");
     const returns = [];
-    try {
-      for (const [path, value] of Object.entries(updates)) await this.applyUpdate(instance, path, value);
-      for (const call of calls) returns.push(await this.call(instance, call.method, call.params));
-    } catch (error) {
-      const errors = error.errors;
-      if (error.kind !== "Validation" || !isRecord(errors)) throw error;
-      state.errors = { ...errors };
-    }
+    await renderPaginated(instance, this.pageUrl(snapshot.memo.path), async () => {
+      await hook2(instance, "hydrate");
+      try {
+        for (const [path, value] of Object.entries(updates)) await this.applyUpdate(instance, path, value);
+        for (const call of calls) returns.push(await this.call(instance, call.method, call.params));
+      } catch (error) {
+        const errors = error.errors;
+        if (error.kind !== "Validation" || !isRecord(errors)) throw error;
+        state.errors = { ...errors };
+      }
+    });
     const memo = { ...snapshot.memo, children: { ...snapshot.memo.children } };
     const effects = this.effects(instance);
     let html;
@@ -3309,25 +3483,30 @@ var LiveComponentManager = class {
     return { instance, snapshot: await this.snapshot(instance, memo), effects, html, tag };
   }
   /**
-   * The route action of POST /oriel/live/update. Each component's update runs behind the auth middleware of the route
-   * that rendered its page (Livewire's persistent middleware): a signed-out tab gets a 401, never the action. When a
-   * middleware answers instead (a redirect), that is the response.
+   * The route action of POST /oriel/live/update. Each component's update runs behind the persistent middleware of the
+   * route that rendered its page (Livewire's): `auth`, `verified`, `guest` and `can`, with the page route's parameters
+   * bound again. A signed-out tab gets a 401, a revoked ability a 403 and a deleted model a 404, before the component
+   * hydrates. When a middleware answers instead (a redirect), that is the response. A key first flashed during the
+   * update shows in this response only, unless the update redirects.
    */
   async handle(request2) {
     if (!this.isLiveRequest(request2)) throw new InvalidLiveRequestError("Live update requests need the X-Oriel-Live header.");
     const container = this.container();
     const persistent = optional(container, ConfigRepository)?.get("live.persistent_middleware", PERSISTENT_MIDDLEWARE) ?? PERSISTENT_MIDDLEWARE;
     const components = [];
+    const flashed = trackFlash(optional(container, Session));
     for (const component of this.payload(request2).components) {
       const { memo } = this.verify(component.snapshot);
-      const middleware = persistentMiddleware(container.make(Router), persistent, memo.method, memo.path);
+      const pass = persistentPass(container.make(Router), persistent, memo.method, memo.path);
+      const update = () => this.updateComponent(component.snapshot, component.updates, component.calls);
       const result = await pageRequest.run(
         { path: memo.path, method: memo.method },
-        () => throughMiddleware(container, request2, middleware, () => this.updateComponent(component.snapshot, component.updates, component.calls))
+        () => pass === void 0 || pass.middleware.length === 0 ? update() : throughMiddleware(container, request2, pass, update)
       );
       if (result instanceof Response) return result;
       components.push({ snapshot: JSON.stringify(result.snapshot), effects: result.effects });
     }
+    flashed(components.some((component) => component.effects.redirect !== void 0));
     return { components };
   }
   /** A full-page component (Route.get('/counter', Counter)): mounted with the route parameters, inside the layout. */
@@ -3402,8 +3581,8 @@ var LiveComponentManager = class {
     const [root, ...rest] = path.split(".");
     const key = rest.length > 0 ? rest.join(".") : void 0;
     const studly = Str.studly(root);
-    await hook(instance, "updating", path, value);
-    await hook(instance, `updating${studly}`, value, key);
+    await hook2(instance, "updating", path, value);
+    await hook2(instance, `updating${studly}`, value, key);
     const target2 = instance;
     if (rest.length === 0) target2[root] = value;
     else {
@@ -3421,8 +3600,8 @@ var LiveComponentManager = class {
       assertSlot(node, last);
       Object.defineProperty(node, last, { value, enumerable: true, writable: true, configurable: true });
     }
-    await hook(instance, "updated", path, value);
-    await hook(instance, `updated${studly}`, value, key);
+    await hook2(instance, "updated", path, value);
+    await hook2(instance, `updated${studly}`, value, key);
   }
   /** Runs one call from the browser: a magic action, an event, or a public method. Returns its return value. */
   async call(instance, method, params) {
@@ -3450,18 +3629,35 @@ var LiveComponentManager = class {
     if (!isCallable(instance, method)) throw new MethodNotCallableError(method, name);
     return instance[method](...params);
   }
-  /** Renders the component (rendering/rendered hooks, nested children tracked) and checks for a single root. */
+  /**
+   * Renders the component (rendering/rendered hooks, nested children tracked) and checks for a single root. A
+   * WithPagination component's page and page URL are what paginate() reads while it renders, as in its mount() and in
+   * its update's hooks and actions.
+   */
   async render(instance, memo, previous) {
-    await hook(instance, "rendering");
+    await hook2(instance, "rendering");
     const context = { previous, children: {}, index: 0 };
-    const html = await renderContext.run(context, async () => {
-      const output = await instance.render();
-      return typeof output === "string" ? output : this.container().make(ViewFactory).renderToString(output);
-    });
-    await hook(instance, "rendered", html);
+    const html = await renderContext.run(
+      context,
+      () => renderPaginated(instance, this.pageUrl(memo.path), async () => {
+        const output = await instance.render();
+        return typeof output === "string" ? output : this.container().make(ViewFactory).renderToString(output);
+      })
+    );
+    await hook2(instance, "rendered", html);
     memo.children = context.children;
     return { html: html.trim(), tag: rootTag(html, memo.name) };
   }
+  /** The absolute URL of the page a memo path belongs to, on the current request's origin ('/' + path without one). */
+  pageUrl(path) {
+    const relative3 = `/${path.replace(/^\/+/, "")}`;
+    const url2 = optional(this.container(), HttpRequest)?.url();
+    try {
+      return url2 === void 0 ? relative3 : new URL(relative3, url2).href;
+    } catch {
+      return relative3;
+    }
+  }
   /** Dispatches, redirects: the effects every response carries. */
   effects(instance) {
     const state = stateOf(instance);
@@ -3480,7 +3676,7 @@ var LiveComponentManager = class {
   }
   /** dehydrate() hook, then the state as snapshot data, the error bag, and the checksum over both. */
   async snapshot(instance, memo) {
-    await hook(instance, "dehydrate");
+    await hook2(instance, "dehydrate");
     const registry = this.registry();
     const data = {};
     for (const [property, value] of Object.entries(instance)) data[property] = dehydrate(value, registry, `${memo.name}.${property}`);
@@ -3553,6 +3749,7 @@ var LiveServiceProvider = class extends ServiceProvider {
     this.mergeConfigFrom({ class_path: this.app.appPath("Live"), layout: "components.layouts.app", persistent_middleware: [...PERSISTENT_MIDDLEWARE] }, "live");
     this.app.singleton(LiveComponentManager, () => new LiveComponentManager(this.app));
     this.app.singleton(LiveManager, (container) => container.make(LiveComponentManager));
+    this.app.singleton(PaginationState, () => livePaginationState);
   }
   async boot() {
     const manager = this.app.make(LiveComponentManager);
@@ -3566,6 +3763,40 @@ var LiveServiceProvider = class extends ServiceProvider {
     }
   }
 };
+function urlWindow(current, last, onEachSide) {
+  const range = (from, to) => Array.from({ length: Math.max(to - from + 1, 0) }, (_, index) => from + index);
+  if (last < onEachSide * 2 + 8) return range(1, last);
+  const size = onEachSide + 4;
+  if (current <= size) return [...range(1, size + onEachSide), "...", ...range(last - 1, last)];
+  if (current > last - size) return [...range(1, 2), "...", ...range(last - (size + (onEachSide - 1)), last)];
+  return [...range(1, 2), "...", ...range(current - onEachSide, current + onEachSide), "...", ...range(last - 1, last)];
+}
+function button(label, action, attributes = "") {
+  const live2 = action === void 0 ? " disabled" : ` o:click="${escapeAttribute2(action)}"`;
+  return `<button type="button" class="btn btn-secondary"${attributes}${live2}>${escapeAttribute2(label)}</button>`;
+}
+function Pagination({ paginator, class: className }) {
+  if (typeof paginator.nextCursor === "function") {
+    throw new LiveError("<Pagination> needs paginate() or simplePaginate(): a cursor paginator has no page numbers.");
+  }
+  const current = paginator.currentPage();
+  const onFirst = paginator.onFirstPage();
+  const hasMore = paginator.hasMorePages();
+  if (onFirst && !hasMore) return { toHtml: () => "" };
+  const parts = [button("\xAB Previous", onFirst ? void 0 : "previousPage")];
+  if (typeof paginator.lastPage === "function") {
+    const onEachSide = Number.isInteger(paginator.onEachSideCount) && paginator.onEachSideCount >= 0 ? paginator.onEachSideCount : 3;
+    for (const page of urlWindow(current, paginator.lastPage(), onEachSide)) {
+      if (page === "...") parts.push('<span aria-hidden="true">...</span>');
+      else if (page === current) parts.push(`<button type="button" class="btn" aria-current="page" disabled>${page}</button>`);
+      else parts.push(button(String(page), `gotoPage(${page})`, ` aria-label="Go to page ${page}"`));
+    }
+  }
+  parts.push(button("Next \xBB", hasMore ? "nextPage" : void 0));
+  const classes = className === void 0 || className === "" ? "" : ` class="${escapeAttribute2(className)}"`;
+  const html = `<nav aria-label="Pagination"${classes}>${parts.join("")}</nav>`;
+  return { toHtml: () => html };
+}
 
 // ../Testing/dist/index.js
 import { AssertionError as AssertionError2 } from "assert";
@@ -3577,6 +3808,7 @@ import { randomUUID } from "crypto";
 import { randomUUID as randomUUID2 } from "crypto";
 import { randomUUID as randomUUID3 } from "crypto";
 import { randomBytes as randomBytes3 } from "crypto";
+import { posix } from "path";
 import { deflateSync } from "zlib";
 function fail2(message, details = {}) {
   const error = new AssertionError2({ message, actual: details.actual, expected: details.expected, operator: "fail" });
@@ -5495,7 +5727,7 @@ var QUEUE_OPTIONS = ["connection", "queue", "delay", "tries", "backoff", "timeou
 function isQueueable(job) {
   if (typeof job !== "object" || job === null) return false;
   const members = job;
-  if (members[SHOULD_QUEUE] === true) return true;
+  if (members.shouldQueue === true || members[SHOULD_QUEUE] === true) return true;
   if (QUEUE_OPTIONS.some((option) => members[option] !== void 0)) return true;
   return typeof members.uniqueId === "function" || typeof members.retryUntil === "function";
 }
@@ -6313,8 +6545,74 @@ var MIME = {
   mp4: "video/mp4"
 };
 function guessMimeType(path) {
-  const extension = path.split(".").pop()?.toLowerCase() ?? "";
-  return MIME[extension];
+  const base = path.slice(path.lastIndexOf("/") + 1);
+  const dot = base.lastIndexOf(".");
+  const extension = dot === -1 ? "" : base.slice(dot + 1).toLowerCase();
+  return Object.hasOwn(MIME, extension) ? MIME[extension] : void 0;
+}
+var DISK_TYPES = {
+  txt: "text/plain",
+  html: "text/html",
+  htm: "text/html",
+  css: "text/css",
+  csv: "text/csv",
+  md: "text/markdown",
+  js: "text/javascript",
+  mjs: "text/javascript",
+  json: "application/json",
+  xml: "application/xml",
+  pdf: "application/pdf",
+  zip: "application/zip",
+  gz: "application/gzip",
+  tar: "application/x-tar",
+  "7z": "application/x-7z-compressed",
+  rar: "application/vnd.rar",
+  epub: "application/epub+zip",
+  rtf: "application/rtf",
+  doc: "application/msword",
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  xls: "application/vnd.ms-excel",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ppt: "application/vnd.ms-powerpoint",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  odt: "application/vnd.oasis.opendocument.text",
+  ods: "application/vnd.oasis.opendocument.spreadsheet",
+  odp: "application/vnd.oasis.opendocument.presentation",
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  avif: "image/avif",
+  svg: "image/svg+xml",
+  ico: "image/x-icon",
+  bmp: "image/bmp",
+  tif: "image/tiff",
+  tiff: "image/tiff",
+  heic: "image/heic",
+  heif: "image/heif",
+  mp3: "audio/mpeg",
+  m4a: "audio/mp4",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  oga: "audio/ogg",
+  opus: "audio/ogg",
+  flac: "audio/flac",
+  aac: "audio/aac",
+  mp4: "video/mp4",
+  mov: "video/quicktime",
+  webm: "video/webm",
+  ogv: "video/ogg",
+  avi: "video/x-msvideo",
+  woff: "font/woff",
+  woff2: "font/woff2",
+  ttf: "font/ttf",
+  otf: "font/otf",
+  wasm: "application/wasm"
+};
+function diskType(extension) {
+  const key = extension.replace(/^\./, "").toLowerCase();
+  return Object.hasOwn(DISK_TYPES, key) ? DISK_TYPES[key] : void 0;
 }
 function hashName(file) {
   const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
@@ -6370,17 +6668,24 @@ var FakeDisk = class {
   async put(path, contents, options = {}) {
     const key = normalize(path);
     const bytes = typeof contents === "string" ? new TextEncoder().encode(contents) : contents instanceof Uint8Array ? contents.slice() : await collect(contents);
-    this.stored.set(key, { bytes, visibility: options.visibility ?? "private", mimeType: options.mimeType ?? guessMimeType(key), modified: /* @__PURE__ */ new Date() });
+    this.write(key, bytes, options.mimeType ?? diskType(posix.extname(key)), options);
     return true;
   }
   putFile(directory, file, options = {}) {
     return this.putFileAs(directory, file, hashName(file), options);
   }
+  /**
+   * The upload's own type, as the S3 disk sends it: its extension(), never the MIME type the client sent as such nor
+   * the stored name's type.
+   */
   async putFileAs(directory, file, name, options = {}) {
     const path = normalize(`${directory}/${name}`);
-    await this.put(path, new Uint8Array(await file.arrayBuffer()), { ...options, mimeType: options.mimeType ?? file.mimeType });
+    this.write(path, new Uint8Array(await file.arrayBuffer()), options.mimeType ?? diskType(file.extension()), options);
     return path;
   }
+  write(key, bytes, mimeType, options) {
+    this.stored.set(key, { bytes, visibility: options.visibility ?? "private", mimeType, modified: /* @__PURE__ */ new Date() });
+  }
   async delete(paths) {
     for (const path of [paths].flat()) this.stored.delete(normalize(path));
     return true;
@@ -6574,6 +6879,37 @@ var StorageFake = class _StorageFake {
     return this.disk().path(path);
   }
 };
+var ascii = (text) => [...text].map((char) => char.charCodeAt(0));
+var u16be = (n) => [n >>> 8 & 255, n & 255];
+var u16le = (n) => [n & 255, n >>> 8 & 255];
+var u32le = (n) => [n & 255, n >>> 8 & 255, n >>> 16 & 255, n >>> 24 & 255];
+function concat(...parts) {
+  const out = new Uint8Array(parts.reduce((n, part) => n + part.length, 0));
+  let offset = 0;
+  for (const part of parts) {
+    out.set(part, offset);
+    offset += part.length;
+  }
+  return out;
+}
+var BitWriter = class {
+  bytes = [];
+  buffer = 0;
+  count = 0;
+  write(value, bits) {
+    this.buffer |= value << this.count;
+    this.count += bits;
+    while (this.count >= 8) {
+      this.bytes.push(this.buffer & 255);
+      this.buffer >>>= 8;
+      this.count -= 8;
+    }
+  }
+  finish() {
+    if (this.count > 0) this.bytes.push(this.buffer & 255);
+    return Uint8Array.from(this.bytes);
+  }
+};
 var CRC_TABLE = Array.from({ length: 256 }, (_, n) => {
   let c = n;
   for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
@@ -6601,23 +6937,175 @@ function png(width, height) {
   header.set([8, 2, 0, 0, 0], 8);
   const rows = new Uint8Array((width * 3 + 1) * height).fill(255);
   for (let y = 0; y < height; y++) rows[y * (width * 3 + 1)] = 0;
-  const parts = [new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]), chunk("IHDR", header), chunk("IDAT", deflateSync(rows)), chunk("IEND", new Uint8Array())];
-  const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
-  let offset = 0;
-  for (const part of parts) {
-    out.set(part, offset);
-    offset += part.length;
-  }
+  return concat([137, 80, 78, 71, 13, 10, 26, 10], chunk("IHDR", header), chunk("IDAT", deflateSync(rows)), chunk("IEND", new Uint8Array()));
+}
+var oneCodeTable = (tableClass) => [255, 196, ...u16be(20), tableClass, 1, ...new Array(15).fill(0), 0];
+function jpeg(width, height) {
+  const bits = Math.ceil(width / 8) * Math.ceil(height / 8) * 2;
+  const scan = new Uint8Array(Math.ceil(bits / 8));
+  const padding = scan.length * 8 - bits;
+  if (padding > 0) scan[scan.length - 1] = (1 << padding) - 1;
+  return concat(
+    [255, 216],
+    // SOI
+    [255, 224, ...u16be(16), ...ascii("JFIF"), 0, 1, 1, 0, 0, 1, 0, 1, 0, 0],
+    // APP0
+    [255, 219, ...u16be(67), 0, ...new Array(64).fill(1)],
+    // DQT: table 0, all ones
+    [255, 192, ...u16be(11), 8, ...u16be(height), ...u16be(width), 1, 1, 17, 0],
+    // SOF0: one component
+    oneCodeTable(0),
+    // DHT: DC table 0
+    oneCodeTable(16),
+    // DHT: AC table 0
+    [255, 218, ...u16be(8), 1, 1, 0, 0, 63, 0],
+    // SOS
+    scan,
+    [255, 217]
+    // EOI
+  );
+}
+function lzwZeros(pixels, minCodeSize) {
+  const clear = 1 << minCodeSize;
+  const end = clear + 1;
+  const out = new BitWriter();
+  const table = /* @__PURE__ */ new Map();
+  let codeSize = minCodeSize + 1;
+  let next = end + 1;
+  let current = 0;
+  out.write(clear, codeSize);
+  for (let i = 1; i < pixels; i++) {
+    const key = current << 8;
+    const known = table.get(key);
+    if (known !== void 0) {
+      current = known;
+      continue;
+    }
+    out.write(current, codeSize);
+    if (next === 4096) {
+      out.write(clear, codeSize);
+      table.clear();
+      codeSize = minCodeSize + 1;
+      next = end + 1;
+    } else {
+      if (next >= 1 << codeSize) codeSize++;
+      table.set(key, next++);
+    }
+    current = 0;
+  }
+  out.write(current, codeSize);
+  out.write(end, codeSize);
+  return out.finish();
+}
+function gif(width, height) {
+  const data = lzwZeros(width * height, 2);
+  const blocks = [];
+  for (let offset = 0; offset < data.length; offset += 255) {
+    const block = data.subarray(offset, offset + 255);
+    blocks.push(block.length, ...block);
+  }
+  return concat(
+    ascii("GIF89a"),
+    [...u16le(width), ...u16le(height), 128, 0, 0],
+    // a global palette of two colours
+    [255, 255, 255, 0, 0, 0],
+    [44, 0, 0, 0, 0, ...u16le(width), ...u16le(height), 0],
+    // the image descriptor
+    [2],
+    blocks,
+    [0, 59]
+    // the end of the data, the trailer
+  );
+}
+function webp(width, height) {
+  const bits = new BitWriter();
+  bits.write(47, 8);
+  bits.write(width - 1, 14);
+  bits.write(height - 1, 14);
+  bits.write(0, 4);
+  bits.write(0, 3);
+  for (const symbol of [255, 255, 255, 255, 0]) {
+    bits.write(1, 1);
+    bits.write(0, 1);
+    bits.write(1, 1);
+    bits.write(symbol, 8);
+  }
+  const data = bits.finish();
+  const padded = data.length % 2 === 0 ? data : concat(data, [0]);
+  return concat(ascii("RIFF"), u32le(12 + padded.length), ascii("WEBP"), ascii("VP8L"), u32le(data.length), padded);
+}
+function bmp(width, height) {
+  const row = Math.ceil(width * 3 / 4) * 4;
+  const out = new Uint8Array(54 + row * height);
+  const view = new DataView(out.buffer);
+  out.set(ascii("BM"));
+  view.setUint32(2, out.length, true);
+  view.setUint32(10, 54, true);
+  view.setUint32(14, 40, true);
+  view.setInt32(18, width, true);
+  view.setInt32(22, height, true);
+  view.setUint16(26, 1, true);
+  view.setUint16(28, 24, true);
+  view.setUint32(34, row * height, true);
+  for (let y = 0; y < height; y++) out.fill(255, 54 + y * row, 54 + y * row + width * 3);
+  return out;
+}
+var IMAGE_FORMATS = {
+  png: { type: "image/png", encode: png },
+  jpg: { type: "image/jpeg", encode: jpeg },
+  jpeg: { type: "image/jpeg", encode: jpeg },
+  gif: { type: "image/gif", encode: gif },
+  webp: { type: "image/webp", encode: webp },
+  bmp: { type: "image/bmp", encode: bmp }
+};
+var extensionOf = (name) => name.includes(".") ? name.slice(name.lastIndexOf(".") + 1).toLowerCase() : "";
+var MORE_MIME_TYPES = {
+  bmp: "image/bmp",
+  avif: "image/avif",
+  xml: "text/xml",
+  htm: "text/html",
+  md: "text/markdown",
+  tsv: "text/tab-separated-values",
+  text: "text/plain"
+};
+var LEADING_BYTES = {
+  "image/jpeg": { bytes: [255, 216, 255, 224, ...u16be(16), ...ascii("JFIF"), 0, 1, 1, 0, 0, 1, 0, 1, 0, 0] },
+  "image/png": { bytes: [137, 80, 78, 71, 13, 10, 26, 10] },
+  "image/gif": { bytes: "GIF89a" },
+  "image/webp": { bytes: "RIFF\0\0\0\0WEBP" },
+  "image/avif": { bytes: [0, 0, 0, 20, ...ascii("ftypavif"), 0, 0, 0, 0, ...ascii("avifmif1")] },
+  "image/bmp": { bytes: [...ascii("BM"), 0, 0, 0, 0, 0, 0, 0, 0, 54, 0, 0, 0, 40, 0, 0, 0] },
+  "application/pdf": { bytes: "%PDF-1.4\n" },
+  "image/svg+xml": { bytes: '<svg xmlns="http://www.w3.org/2000/svg"/>\n', text: true },
+  "text/html": { bytes: "<!doctype html>\n", text: true },
+  "text/xml": { bytes: '<?xml version="1.0"?>\n', text: true }
+};
+function contentFor(type, size) {
+  const text = type.startsWith("text/") || type === "application/json";
+  const leading = LEADING_BYTES[type] ?? { bytes: text ? "\n" : [], text };
+  const head = typeof leading.bytes === "string" ? new TextEncoder().encode(leading.bytes) : Uint8Array.from(leading.bytes);
+  const out = new Uint8Array(Math.max(size, head.length, 1)).fill(leading.text ? 32 : 0);
+  out.set(head);
   return out;
 }
 var FakeFile = {
-  /** A file of `kilobytes` KiB (zero bytes), typed by `mimeType` or the extension. */
+  /**
+   * A file of `kilobytes` KiB typed by `mimeType` or the name's extension. Validation reads a file's bytes, so the
+   * file starts like its type (a PDF's `%PDF-`, a PNG's signature, text for text types) and passes `mimes` for its
+   * name, as Laravel's fakes do. It is at least its type's leading bytes and never empty, whatever the size asked for.
+   * An image made this way has no readable size: use image() for `dimensions`.
+   */
   create(name, kilobytes = 0, mimeType) {
-    return new File([new Uint8Array(Math.round(kilobytes * 1024))], name, { type: mimeType ?? guessMimeType(name) ?? "application/octet-stream" });
+    const type = mimeType ?? guessMimeType(name) ?? MORE_MIME_TYPES[extensionOf(name)] ?? "application/octet-stream";
+    return new File([contentFor(type, Math.round(kilobytes * 1024))], name, { type });
   },
-  /** A real PNG image of the given size (typed by the name's extension, like Laravel's image()). */
+  /**
+   * A real white image of the given size in the format the name's extension asks for: png, jpg/jpeg, gif, webp or
+   * bmp (any other name gets a JPEG, as Laravel's fakes do), so image, mimes and dimensions pass on it.
+   */
   image(name, width = 10, height = 10) {
-    return new File([png(width, height)], name, { type: guessMimeType(name) ?? "image/png" });
+    const format2 = IMAGE_FORMATS[extensionOf(name)] ?? IMAGE_FORMATS.jpeg;
+    return new File([format2.encode(width, height)], name, { type: guessMimeType(name) ?? format2.type });
   }
 };
 
@@ -6718,9 +7206,11 @@ export {
   componentName,
   PERSISTENT_MIDDLEWARE,
   persistentMiddleware,
+  WithPagination,
   LiveComponentManager,
   UPDATE_URI,
   LiveServiceProvider,
+  Pagination,
   PendingCommand,
   RefreshDatabaseState,
   runCommand,
@@ -6766,4 +7256,4 @@ export {
   StorageFake,
   FakeFile
 };
-//# sourceMappingURL=chunk-SBZQ6L3Z.js.map
+//# sourceMappingURL=chunk-WNJP46B7.js.map