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

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

@@ -10,7 +10,7 @@ import {
   facade,
   fileType_exports,
   inject
-} from "./chunk-PM5YTG57.js";
+} from "./chunk-POEP4B2M.js";
 import {
   Application,
   AuthFactory,
@@ -45,7 +45,7 @@ import {
   ValidationFactory,
   ViewFactory,
   token
-} from "./chunk-BSQKOLSK.js";
+} from "./chunk-I63ZFMX6.js";
 
 // ../Config/dist/index.js
 import { existsSync, readFileSync } from "fs";
@@ -492,7 +492,7 @@ var Application2 = class _Application extends Container {
     this.scoped(Vite, () => new Vite(this));
   }
   base;
-  version = "0.1.0-alpha.5";
+  version = "0.1.0-alpha.6";
   providers = [];
   bootingCallbacks = [];
   bootedCallbacks = [];
@@ -1290,9 +1290,14 @@ var IncomingRequest = class {
   filled(key) {
     return !isBlank(Arr.get(this.all(), key));
   }
+  /** Laravel's string(): the input as a Stringable (the default when it is missing or null): request().string('q').trim(). */
   string(key, defaultValue = "") {
     const value = this.input(key);
-    return value === void 0 || value === null ? defaultValue : String(value);
+    return Str.of(value === void 0 || value === null ? defaultValue : value);
+  }
+  /** Laravel's str(): string() under its short name. */
+  str(key, defaultValue = "") {
+    return this.string(key, defaultValue);
   }
   /** PHP's FILTER_VALIDATE_BOOLEAN: '1', 'true', 'on', 'yes' (any case) and true are true. */
   boolean(key, defaultValue = false) {
@@ -2510,6 +2515,48 @@ 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";
+var LiveError = class extends Error {
+  name = "LiveError";
+  kind = "Server";
+  status = 500;
+};
+var CorruptComponentPayloadError = class extends LiveError {
+  name = "CorruptComponentPayloadError";
+  kind = "Authorization";
+  status = 403;
+  constructor(component = "unknown") {
+    super(`Live encountered corrupt data when trying to hydrate the [${component}] component.`);
+  }
+};
+var MethodNotCallableError = class extends LiveError {
+  name = "MethodNotCallableError";
+  kind = "Authorization";
+  status = 403;
+  constructor(method, component) {
+    super(`Unable to call component method. Public method [${method}] not found on component [${component}].`);
+  }
+};
+var PropertyNotUpdatableError = class extends LiveError {
+  name = "PropertyNotUpdatableError";
+  kind = "Authorization";
+  status = 403;
+  constructor(path, component) {
+    super(`Cannot update property [${path}] on component [${component}]: it is not a public, unlocked property.`);
+  }
+};
+var LiveComponentNotFoundError = class extends LiveError {
+  name = "LiveComponentNotFoundError";
+  kind = "Http";
+  status = 404;
+  constructor(component) {
+    super(`Unable to find component: [${component}].`);
+  }
+};
+var InvalidLiveRequestError = class extends LiveError {
+  name = "InvalidLiveRequestError";
+  kind = "Http";
+  status = 400;
+};
 Symbol.metadata ??= /* @__PURE__ */ Symbol.for("Symbol.metadata");
 var LISTENERS = /* @__PURE__ */ Symbol.for("oriel:live.listeners");
 var LOCKED = /* @__PURE__ */ Symbol.for("oriel:live.locked");
@@ -2581,6 +2628,145 @@ function lockedOf(cls) {
 function computedOf(cls) {
   return /* @__PURE__ */ new Set([...metadataOf(cls)[COMPUTED] ?? [], ...staticsOf(cls, "computed").flat()]);
 }
+function isModel(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return typeof candidate.getKey === "function" && typeof candidate.getKeyName === "function" && typeof candidate.getTable === "function" && typeof candidate.exists === "boolean";
+}
+var isPlainObject2 = (value) => {
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+};
+var isTuple = (value) => Array.isArray(value) && value.length === 2 && typeof value[1] === "object" && value[1] !== null && !Array.isArray(value[1]) && typeof value[1].s === "string";
+function classNameOf(registry, cls) {
+  return registry.nameOf(cls) ?? registry.register(cls);
+}
+function dehydrate(value, registry, path, seen = /* @__PURE__ */ new Set()) {
+  switch (typeof value) {
+    case "undefined":
+      return [null, { s: "u" }];
+    case "string":
+    case "boolean":
+      return value;
+    case "number":
+      if (!Number.isFinite(value)) throw new LiveError(`Property [${path}] is ${value}: Live state must be JSON (finite numbers only).`);
+      return value;
+    case "bigint":
+    case "symbol":
+    case "function":
+      throw new LiveError(`Property [${path}] holds a ${typeof value}: Live state may only hold primitives, arrays, plain objects, Dates, models and collections.`);
+  }
+  if (value === null) return null;
+  const object = value;
+  if (seen.has(object)) throw new LiveError(`Property [${path}] contains a circular reference.`);
+  seen.add(object);
+  try {
+    if (object instanceof Date) return [object.toISOString(), { s: "dt" }];
+    if (Array.isArray(object)) return [object.map((item, i) => dehydrate(item, registry, `${path}.${i}`, seen)), { s: "arr" }];
+    if (isModel(object)) {
+      const name = classNameOf(registry, object.constructor);
+      if (!object.exists) throw new LiveError(`Property [${path}] holds an unsaved [${name}] model: only saved models can be kept between requests.`);
+      return [null, { s: "mdl", class: name, key: object.getKey() }];
+    }
+    if (object instanceof Collection) {
+      const items = object.all();
+      const first = items[0];
+      if (items.length > 0 && isModel(first) && items.every((item) => isModel(item) && item.constructor === first.constructor)) {
+        for (const [i, item] of items.entries()) {
+          if (!item.exists) throw new LiveError(`Property [${path}.${i}] holds an unsaved model.`);
+        }
+        const name = classNameOf(registry, first.constructor);
+        return [null, { s: "elcln", class: name, keys: items.map((item) => item.getKey()) }];
+      }
+      return [items.map((item, i) => dehydrate(item, registry, `${path}.${i}`, seen)), { s: "clctn" }];
+    }
+    if (isPlainObject2(object)) {
+      const out = {};
+      for (const [key, item] of Object.entries(object)) out[key] = dehydrate(item, registry, `${path}.${key}`, seen);
+      return [out, { s: "obj" }];
+    }
+    const type = object.constructor?.name || "object";
+    throw new LiveError(
+      `Property [${path}] holds a [${type}] instance: Live state may only hold primitives, arrays, plain objects, Dates, models and collections.`
+    );
+  } finally {
+    seen.delete(object);
+  }
+}
+function modelClass(registry, name) {
+  if (typeof name !== "string" || !registry.has(name)) throw new LiveError(`Unable to hydrate the [${String(name)}] model: it is not registered.`);
+  return registry.resolve(name);
+}
+async function hydrate(value, registry) {
+  if (!isTuple(value)) return value;
+  const [inner, meta] = value;
+  switch (meta.s) {
+    case "u":
+      return void 0;
+    case "dt":
+      return new Date(String(inner));
+    case "arr":
+      return Promise.all(inner.map((item) => hydrate(item, registry)));
+    case "clctn":
+      return new Collection(await Promise.all(inner.map((item) => hydrate(item, registry))));
+    case "obj": {
+      const out = {};
+      for (const [key, item] of Object.entries(inner)) {
+        Object.defineProperty(out, key, { value: await hydrate(item, registry), enumerable: true, writable: true, configurable: true });
+      }
+      return out;
+    }
+    case "mdl":
+      return modelClass(registry, meta.class).findOrFail(meta.key);
+    case "elcln": {
+      const cls = modelClass(registry, meta.class);
+      const keys = meta.keys ?? [];
+      const keyName = new cls().getKeyName();
+      const found = [...await cls.query().whereIn(keyName, keys).get()];
+      const byKey = new Map(found.map((model) => [String(model.getKey()), model]));
+      return new Collection(keys.map((key) => byKey.get(String(key))).filter((model) => model !== void 0));
+    }
+  }
+  throw new LiveError(`Unknown snapshot value type [${String(meta.s)}].`);
+}
+var HOOKS = /* @__PURE__ */ new Set(["constructor", "render", "mount", "boot", "booted", "hydrate", "dehydrate", "updating", "updated", "rendering", "rendered", "exception"]);
+var HOOK_PREFIX = /^(updating|updated|hydrate|dehydrate)[A-Z_]/;
+var UNSAFE_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+var baseApi;
+var isBaseApi = (name) => (baseApi ??= new Set(Object.getOwnPropertyNames(Component.prototype))).has(name);
+var INDEX = /^(?:0|[1-9]\d*)$/;
+function isArraySlot(array, segment) {
+  return INDEX.test(segment) && Number(segment) <= array.length;
+}
+function isCallable(instance, method) {
+  if (method === "" || method.startsWith("_") || method.startsWith("$") || method.startsWith("#")) return false;
+  if (HOOKS.has(method) || HOOK_PREFIX.test(method) || isBaseApi(method)) return false;
+  if (lockedOf(instance.constructor).has(method)) return false;
+  const isBase = (proto) => proto === Component.prototype || proto === Object.prototype;
+  for (let proto = Object.getPrototypeOf(instance); proto !== null && !isBase(proto); proto = Object.getPrototypeOf(proto)) {
+    const descriptor = Object.getOwnPropertyDescriptor(proto, method);
+    if (descriptor !== void 0) return typeof descriptor.value === "function";
+  }
+  return false;
+}
+function isUpdatable(instance, path) {
+  const segments = path.split(".");
+  const root = segments[0];
+  if (root === "" || root.startsWith("_") || segments.some((segment) => segment === "" || UNSAFE_SEGMENTS.has(segment))) return false;
+  if (!Object.hasOwn(instance, root)) return false;
+  const descriptor = Object.getOwnPropertyDescriptor(instance, root);
+  if (!descriptor.enumerable || descriptor.get !== void 0) return false;
+  const cls = instance.constructor;
+  if (lockedOf(cls).has(root) || computedOf(cls).has(root)) return false;
+  let node = descriptor.value;
+  for (const segment of segments.slice(1)) {
+    if (isModel(node) || node instanceof Collection) return false;
+    if (Array.isArray(node) && !isArraySlot(node, segment)) return false;
+    if (typeof node !== "object" || node === null || !Object.hasOwn(node, segment)) return true;
+    node = node[segment];
+  }
+  return !isModel(node) && !(node instanceof Collection);
+}
 var COMPONENT = /* @__PURE__ */ Symbol.for("oriel:live.component");
 var states = /* @__PURE__ */ new WeakMap();
 function stateOf(component) {
@@ -2711,6 +2897,23 @@ var Component = class {
   skipRender() {
     stateOf(this).skipRender = true;
   }
+  /**
+   * An action for an `o:` directive, typed against its method: `o:click={this.$action(this.delete, tag.id)}` writes
+   * `delete(5)`, and a string where `delete` takes a number is a type error. The arguments are written as JSON, the
+   * trailing `undefined` ones left out so the method's defaults apply. The method must be one of this component's
+   * actions (a public method of its class, not a hook and not @Locked); anything else throws while rendering.
+   */
+  $action(method, ...params) {
+    const name = typeof method === "function" ? method.name : "";
+    if (name === "" || this[name] !== method || !isCallable(this, name)) {
+      throw new LiveError(
+        `[${name === "" ? "anonymous function" : name}] is not an action of [${this.getName() || this.constructor.name}]: pass one of its public methods, as in this.$action(this.save).`
+      );
+    }
+    let count = params.length;
+    while (count > 0 && params[count - 1] === void 0) count--;
+    return count === 0 ? name : `${name}(${params.slice(0, count).map((param) => JSON.stringify(param) ?? "null").join(", ")})`;
+  }
   /** A full-page component as a route action: Route.get('/counter', Counter). Route parameters go to mount(). */
   async __invoke() {
     return inject(LiveManager).page(this);
@@ -2730,52 +2933,13 @@ function trackFlash(session, { saved = true } = {}) {
     session.put("_flash.old", [...old, ...fresh.filter((key) => !old.includes(key))]);
   };
 }
-var LiveError = class extends Error {
-  name = "LiveError";
-  kind = "Server";
-  status = 500;
-};
-var CorruptComponentPayloadError = class extends LiveError {
-  name = "CorruptComponentPayloadError";
-  kind = "Authorization";
-  status = 403;
-  constructor(component = "unknown") {
-    super(`Live encountered corrupt data when trying to hydrate the [${component}] component.`);
-  }
-};
-var MethodNotCallableError = class extends LiveError {
-  name = "MethodNotCallableError";
-  kind = "Authorization";
-  status = 403;
-  constructor(method, component) {
-    super(`Unable to call component method. Public method [${method}] not found on component [${component}].`);
-  }
-};
-var PropertyNotUpdatableError = class extends LiveError {
-  name = "PropertyNotUpdatableError";
-  kind = "Authorization";
-  status = 403;
-  constructor(path, component) {
-    super(`Cannot update property [${path}] on component [${component}]: it is not a public, unlocked property.`);
-  }
-};
-var LiveComponentNotFoundError = class extends LiveError {
-  name = "LiveComponentNotFoundError";
-  kind = "Http";
-  status = 404;
-  constructor(component) {
-    super(`Unable to find component: [${component}].`);
-  }
-};
-var InvalidLiveRequestError = class extends LiveError {
-  name = "InvalidLiveRequestError";
-  kind = "Http";
-  status = 400;
-};
 var ESCAPES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#039;" };
 function escapeAttribute2(value) {
   return value.replace(/[&<>"']/g, (char) => ESCAPES[char]);
 }
+function stripTags(html) {
+  return html.replace(/<[^>]*>/g, "");
+}
 var VOID = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "source", "track", "wbr"]);
 var RAW_TEXT = /* @__PURE__ */ new Set(["script", "style", "textarea", "title"]);
 var TOKEN = /<\/([A-Za-z][\w:-]*)\s*>|<([A-Za-z][\w:-]*)(?:\s+[^\s"'<>/=]+(?:\s*=\s*(?:"[^"]*"|'[^']*'|[^\s"'=<>`]+))?)*\s*(\/?)>/g;
@@ -2928,6 +3092,17 @@ var Testable = class _Testable {
     for (const value of values) if (!this.html().includes(value)) fail(`Failed asserting that [${value}] is in the rendered HTML.`, this.html(), value);
     return this;
   }
+  /** Each value, HTML-escaped, appears in the rendered text: the HTML with its tags stripped (Livewire's assertSeeText). */
+  assertSeeText(...values) {
+    const text = stripTags(this.html());
+    for (const value of values) if (!text.includes(escapeAttribute2(value))) fail(`Failed asserting that [${value}] is in the rendered text.`, text, value);
+    return this;
+  }
+  assertDontSeeText(...values) {
+    const text = stripTags(this.html());
+    for (const value of values) if (text.includes(escapeAttribute2(value))) fail(`Failed asserting that [${value}] is not in the rendered text.`, text, value);
+    return this;
+  }
   assertDispatched(name, params) {
     const dispatched = (this.#effects.dispatches ?? []).filter((event) => event.name === name);
     if (dispatched.length === 0) fail(`Failed asserting that an event [${name}] was dispatched.`, this.#effects.dispatches ?? [], name);
@@ -3111,7 +3286,7 @@ function currentRoute(container) {
   }
 }
 async function throughMiddleware(container, request2, pass, destination) {
-  const original = currentRoute(container);
+  const original2 = currentRoute(container);
   const page = { route: pass.route, parameters: { ...pass.values }, middleware: [] };
   let swapped = false;
   const show = () => {
@@ -3120,8 +3295,8 @@ async function throughMiddleware(container, request2, pass, destination) {
   };
   const restore = () => {
     if (!swapped) return;
-    if (original === void 0) container.forgetInstance(CurrentRoute);
-    else container.instance(CurrentRoute, original);
+    if (original2 === void 0) container.forgetInstance(CurrentRoute);
+    else container.instance(CurrentRoute, original2);
     swapped = false;
   };
   let ran;
@@ -3145,144 +3320,6 @@ async function throughMiddleware(container, request2, pass, destination) {
     restore();
   }
 }
-function isModel(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const candidate = value;
-  return typeof candidate.getKey === "function" && typeof candidate.getKeyName === "function" && typeof candidate.getTable === "function" && typeof candidate.exists === "boolean";
-}
-var isPlainObject2 = (value) => {
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-};
-var isTuple = (value) => Array.isArray(value) && value.length === 2 && typeof value[1] === "object" && value[1] !== null && !Array.isArray(value[1]) && typeof value[1].s === "string";
-function classNameOf(registry, cls) {
-  return registry.nameOf(cls) ?? registry.register(cls);
-}
-function dehydrate(value, registry, path, seen = /* @__PURE__ */ new Set()) {
-  switch (typeof value) {
-    case "undefined":
-      return [null, { s: "u" }];
-    case "string":
-    case "boolean":
-      return value;
-    case "number":
-      if (!Number.isFinite(value)) throw new LiveError(`Property [${path}] is ${value}: Live state must be JSON (finite numbers only).`);
-      return value;
-    case "bigint":
-    case "symbol":
-    case "function":
-      throw new LiveError(`Property [${path}] holds a ${typeof value}: Live state may only hold primitives, arrays, plain objects, Dates, models and collections.`);
-  }
-  if (value === null) return null;
-  const object = value;
-  if (seen.has(object)) throw new LiveError(`Property [${path}] contains a circular reference.`);
-  seen.add(object);
-  try {
-    if (object instanceof Date) return [object.toISOString(), { s: "dt" }];
-    if (Array.isArray(object)) return [object.map((item, i) => dehydrate(item, registry, `${path}.${i}`, seen)), { s: "arr" }];
-    if (isModel(object)) {
-      const name = classNameOf(registry, object.constructor);
-      if (!object.exists) throw new LiveError(`Property [${path}] holds an unsaved [${name}] model: only saved models can be kept between requests.`);
-      return [null, { s: "mdl", class: name, key: object.getKey() }];
-    }
-    if (object instanceof Collection) {
-      const items = object.all();
-      const first = items[0];
-      if (items.length > 0 && isModel(first) && items.every((item) => isModel(item) && item.constructor === first.constructor)) {
-        for (const [i, item] of items.entries()) {
-          if (!item.exists) throw new LiveError(`Property [${path}.${i}] holds an unsaved model.`);
-        }
-        const name = classNameOf(registry, first.constructor);
-        return [null, { s: "elcln", class: name, keys: items.map((item) => item.getKey()) }];
-      }
-      return [items.map((item, i) => dehydrate(item, registry, `${path}.${i}`, seen)), { s: "clctn" }];
-    }
-    if (isPlainObject2(object)) {
-      const out = {};
-      for (const [key, item] of Object.entries(object)) out[key] = dehydrate(item, registry, `${path}.${key}`, seen);
-      return [out, { s: "obj" }];
-    }
-    const type = object.constructor?.name || "object";
-    throw new LiveError(
-      `Property [${path}] holds a [${type}] instance: Live state may only hold primitives, arrays, plain objects, Dates, models and collections.`
-    );
-  } finally {
-    seen.delete(object);
-  }
-}
-function modelClass(registry, name) {
-  if (typeof name !== "string" || !registry.has(name)) throw new LiveError(`Unable to hydrate the [${String(name)}] model: it is not registered.`);
-  return registry.resolve(name);
-}
-async function hydrate(value, registry) {
-  if (!isTuple(value)) return value;
-  const [inner, meta] = value;
-  switch (meta.s) {
-    case "u":
-      return void 0;
-    case "dt":
-      return new Date(String(inner));
-    case "arr":
-      return Promise.all(inner.map((item) => hydrate(item, registry)));
-    case "clctn":
-      return new Collection(await Promise.all(inner.map((item) => hydrate(item, registry))));
-    case "obj": {
-      const out = {};
-      for (const [key, item] of Object.entries(inner)) {
-        Object.defineProperty(out, key, { value: await hydrate(item, registry), enumerable: true, writable: true, configurable: true });
-      }
-      return out;
-    }
-    case "mdl":
-      return modelClass(registry, meta.class).findOrFail(meta.key);
-    case "elcln": {
-      const cls = modelClass(registry, meta.class);
-      const keys = meta.keys ?? [];
-      const keyName = new cls().getKeyName();
-      const found = [...await cls.query().whereIn(keyName, keys).get()];
-      const byKey = new Map(found.map((model) => [String(model.getKey()), model]));
-      return new Collection(keys.map((key) => byKey.get(String(key))).filter((model) => model !== void 0));
-    }
-  }
-  throw new LiveError(`Unknown snapshot value type [${String(meta.s)}].`);
-}
-var HOOKS = /* @__PURE__ */ new Set(["constructor", "render", "mount", "boot", "booted", "hydrate", "dehydrate", "updating", "updated", "rendering", "rendered", "exception"]);
-var HOOK_PREFIX = /^(updating|updated|hydrate|dehydrate)[A-Z_]/;
-var UNSAFE_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
-var BASE_API = new Set(Object.getOwnPropertyNames(Component.prototype));
-var INDEX = /^(?:0|[1-9]\d*)$/;
-function isArraySlot(array, segment) {
-  return INDEX.test(segment) && Number(segment) <= array.length;
-}
-function isCallable(instance, method) {
-  if (method === "" || method.startsWith("_") || method.startsWith("$") || method.startsWith("#")) return false;
-  if (HOOKS.has(method) || HOOK_PREFIX.test(method) || BASE_API.has(method)) return false;
-  if (lockedOf(instance.constructor).has(method)) return false;
-  const isBase = (proto) => proto === Component.prototype || proto === Object.prototype;
-  for (let proto = Object.getPrototypeOf(instance); proto !== null && !isBase(proto); proto = Object.getPrototypeOf(proto)) {
-    const descriptor = Object.getOwnPropertyDescriptor(proto, method);
-    if (descriptor !== void 0) return typeof descriptor.value === "function";
-  }
-  return false;
-}
-function isUpdatable(instance, path) {
-  const segments = path.split(".");
-  const root = segments[0];
-  if (root === "" || root.startsWith("_") || segments.some((segment) => segment === "" || UNSAFE_SEGMENTS.has(segment))) return false;
-  if (!Object.hasOwn(instance, root)) return false;
-  const descriptor = Object.getOwnPropertyDescriptor(instance, root);
-  if (!descriptor.enumerable || descriptor.get !== void 0) return false;
-  const cls = instance.constructor;
-  if (lockedOf(cls).has(root) || computedOf(cls).has(root)) return false;
-  let node = descriptor.value;
-  for (const segment of segments.slice(1)) {
-    if (isModel(node) || node instanceof Collection) return false;
-    if (Array.isArray(node) && !isArraySlot(node, segment)) return false;
-    if (typeof node !== "object" || node === null || !Object.hasOwn(node, segment)) return true;
-    node = node[segment];
-  }
-  return !isModel(node) && !(node instanceof Collection);
-}
 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;
@@ -3810,6 +3847,129 @@ import { randomUUID as randomUUID3 } from "crypto";
 import { randomBytes as randomBytes3 } from "crypto";
 import { posix } from "path";
 import { deflateSync } from "zlib";
+var original;
+var testNow;
+var realDate = () => original ?? globalThis.Date;
+function install() {
+  if (original !== void 0) return;
+  const Real = original = globalThis.Date;
+  const current = () => testNow ?? Real.now();
+  const Travelling = new Proxy(Real, {
+    construct: (target2, args, newTarget) => Reflect.construct(target2, args.length === 0 ? [current()] : args, newTarget === Travelling ? target2 : newTarget),
+    apply: (target2) => new target2(current()).toString(),
+    get: (target2, property) => property === "now" ? current : Reflect.get(target2, property, target2)
+  });
+  globalThis.Date = Travelling;
+}
+function setTestNow(date) {
+  const time = new (realDate())(date).getTime();
+  if (Number.isNaN(time)) throw new TypeError(`Invalid date: ${String(date)}`);
+  install();
+  testNow = time;
+  return new (realDate())(time);
+}
+function thenTravelBack(callback) {
+  let result;
+  try {
+    result = callback();
+  } catch (error) {
+    travelBack();
+    throw error;
+  }
+  if (result instanceof Promise) return result.finally(travelBack);
+  travelBack();
+  return result;
+}
+function travelTo(date, callback) {
+  const at = setTestNow(date);
+  if (callback) return thenTravelBack(() => callback(at));
+}
+function travelBack() {
+  if (original !== void 0) globalThis.Date = original;
+  original = void 0;
+  testNow = void 0;
+  return /* @__PURE__ */ new Date();
+}
+function freezeTime(callback) {
+  const at = new (realDate())(testNow ?? Date.now());
+  if (callback) return travelTo(at, callback);
+  travelTo(at);
+  return at;
+}
+function freezeSecond(callback) {
+  const at = new (realDate())(testNow ?? Date.now());
+  at.setMilliseconds(0);
+  if (callback) return travelTo(at, callback);
+  travelTo(at);
+  return at;
+}
+function travel(value) {
+  return new Wormhole(value);
+}
+var Wormhole = class {
+  constructor(value) {
+    this.value = value;
+  }
+  value;
+  millisecond(callback) {
+    return this.milliseconds(callback);
+  }
+  milliseconds(callback) {
+    return this.#move((date) => date.setTime(date.getTime() + this.value), callback);
+  }
+  second(callback) {
+    return this.seconds(callback);
+  }
+  seconds(callback) {
+    return this.#move((date) => date.setTime(date.getTime() + this.value * 1e3), callback);
+  }
+  minute(callback) {
+    return this.minutes(callback);
+  }
+  minutes(callback) {
+    return this.#move((date) => date.setTime(date.getTime() + this.value * 6e4), callback);
+  }
+  hour(callback) {
+    return this.hours(callback);
+  }
+  hours(callback) {
+    return this.#move((date) => date.setTime(date.getTime() + this.value * 36e5), callback);
+  }
+  day(callback) {
+    return this.days(callback);
+  }
+  days(callback) {
+    return this.#move((date) => date.setUTCDate(date.getUTCDate() + this.value), callback);
+  }
+  week(callback) {
+    return this.weeks(callback);
+  }
+  weeks(callback) {
+    return this.#move((date) => date.setUTCDate(date.getUTCDate() + this.value * 7), callback);
+  }
+  month(callback) {
+    return this.months(callback);
+  }
+  months(callback) {
+    return this.#move((date) => date.setUTCMonth(date.getUTCMonth() + this.value), callback);
+  }
+  year(callback) {
+    return this.years(callback);
+  }
+  years(callback) {
+    return this.#move((date) => date.setUTCFullYear(date.getUTCFullYear() + this.value), callback);
+  }
+  /** Laravel's Wormhole::back(). */
+  static back() {
+    return travelBack();
+  }
+  #move(step, callback) {
+    const date = new (realDate())(testNow ?? Date.now());
+    step(date);
+    setTestNow(date);
+    if (callback) return thenTravelBack(callback);
+  }
+};
 function fail2(message, details = {}) {
   const error = new AssertionError2({ message, actual: details.actual, expected: details.expected, operator: "fail" });
   delete error.diff;
@@ -3831,7 +3991,7 @@ function format(value) {
 function escapeHtml2(value) {
   return value.replace(/[&<>"']/g, (char) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#039;" })[char]);
 }
-function stripTags(html) {
+function stripTags2(html) {
   return html.replace(/<[^>]*>/g, "");
 }
 function equals(a, b) {
@@ -4732,7 +4892,7 @@ ${this.excerpt()}`);
   }
   /** Like assertSee, against the content with its tags stripped. */
   assertSeeText(value, escape = true) {
-    const text = stripTags(this.content);
+    const text = stripTags2(this.content);
     for (const needle of this.needles(value, escape)) {
       assert(text.includes(needle), `Failed asserting that the response text contains [${needle}].
 
@@ -4741,14 +4901,14 @@ ${this.excerpt(text)}`);
     return this;
   }
   assertDontSeeText(value, escape = true) {
-    const text = stripTags(this.content);
+    const text = stripTags2(this.content);
     for (const needle of this.needles(value, escape)) {
       assert(!text.includes(needle), `Failed asserting that the response text does not contain [${needle}].`);
     }
     return this;
   }
   assertSeeTextInOrder(values, escape = true) {
-    return this.inOrder(stripTags(this.content), this.needles(values, escape));
+    return this.inOrder(stripTags2(this.content), this.needles(values, escape));
   }
   // JSON --------------------------------------------------------------------------------------------------
   /**
@@ -5696,9 +5856,33 @@ var InteractsWithConsole = class extends InteractsWithDatabase {
     return new PendingCommand(this.app, command, parameters);
   }
 };
-var TestCase = class extends InteractsWithConsole {
+var InteractsWithTime = class extends InteractsWithConsole {
+  travelTo(date, callback) {
+    return callback ? travelTo(date, callback) : travelTo(date);
+  }
+  travel(value) {
+    return travel(value);
+  }
+  travelBack() {
+    return travelBack();
+  }
+  freezeTime(callback) {
+    return callback ? freezeTime(callback) : freezeTime();
+  }
+  freezeSecond(callback) {
+    return callback ? freezeSecond(callback) : freezeSecond();
+  }
+  async tearDown() {
+    try {
+      await super.tearDown();
+    } finally {
+      travelBack();
+    }
+  }
+};
+var TestCase = class extends InteractsWithTime {
 };
-function install(token2, fake) {
+function install2(token2, fake) {
   facade(token2).swap(fake);
   return fake;
 }
@@ -5731,6 +5915,23 @@ function isQueueable(job) {
   if (QUEUE_OPTIONS.some((option) => members[option] !== void 0)) return true;
   return typeof members.uniqueId === "function" || typeof members.retryUntil === "function";
 }
+var isClass = (value) => typeof value === "function" && typeof value.prototype?.handle === "function";
+var asPair = (listener) => {
+  if (Array.isArray(listener) && listener.length === 2 && typeof listener[1] === "string") return [listener[0], listener[1]];
+  return isClass(listener) ? [listener, "handle"] : void 0;
+};
+function listenerMatches(registered, expected) {
+  if (expected === Function) return typeof registered === "function" && !isClass(registered);
+  const [left, right] = [asPair(registered), asPair(expected)];
+  if (left && right) return left[0] === right[0] && left[1] === right[1];
+  return registered === expected;
+}
+function listenerName(listener) {
+  const pair = asPair(listener);
+  if (pair === void 0) return "Closure";
+  const [owner, method] = pair;
+  return Array.isArray(listener) ? `${owner.name}@${method}` : owner.name;
+}
 var EventFake = class _EventFake {
   constructor(dispatcher, eventsToFake = [], eventsToDispatch = []) {
     this.dispatcher = dispatcher;
@@ -5743,11 +5944,11 @@ var EventFake = class _EventFake {
   events = [];
   /** Installs the fake (on the current container) and returns it: `const events = EventFake.fake([OrderShipped])`. */
   static fake(eventsToFake = []) {
-    return install(EventDispatcher, new _EventFake(_EventFake.original(), [eventsToFake].flat()));
+    return install2(EventDispatcher, new _EventFake(_EventFake.original(), [eventsToFake].flat()));
   }
   /** Fakes every event except these. */
   static fakeExcept(eventsToDispatch) {
-    return install(EventDispatcher, new _EventFake(_EventFake.original(), [], [eventsToDispatch].flat()));
+    return install2(EventDispatcher, new _EventFake(_EventFake.original(), [], [eventsToDispatch].flat()));
   }
   static original() {
     const current = bound(EventDispatcher);
@@ -5804,9 +6005,20 @@ var EventFake = class _EventFake {
 
 - ${names.join("\n- ")}`);
   }
-  /** The original dispatcher has a listener for the event. */
-  assertListening(event) {
-    assert(this.hasListeners(event), `Event [${nameOf(event)}] does not have any listeners.`);
+  /**
+   * Laravel's assertListening(event, listener): the original dispatcher has that listener for the event (a class, a
+   * [class, method] pair, the same closure, or Function for any closure; wildcard listeners count for a string event).
+   * With only the event, any listener will do.
+   */
+  assertListening(event, listener) {
+    if (listener === void 0) {
+      assert(this.hasListeners(event), `Event [${nameOf(event)}] does not have any listeners.`);
+      return;
+    }
+    assert(
+      this.listenersFor(event).some((registered) => listenerMatches(registered, listener)),
+      `Event [${nameOf(event)}] does not have the [${listenerName(listener)}] listener attached to it`
+    );
   }
   /** The recorded events (objects, or names for string events) that match. */
   dispatched(event, callback) {
@@ -5815,6 +6027,17 @@ var EventFake = class _EventFake {
   hasDispatched(event) {
     return this.dispatched(event).length > 0;
   }
+  /** The original dispatcher's listeners for the event, as registered, wildcard ones included for a string event. */
+  listenersFor(event) {
+    const raw = this.dispatcher?.getRawListeners?.();
+    if (raw === void 0) return [];
+    const listeners = [...raw.get(event) ?? []];
+    if (typeof event !== "string") return listeners;
+    for (const [key, list] of raw) {
+      if (typeof key === "string" && key !== event && key.includes("*") && Str.is(key, event)) listeners.push(...list);
+    }
+    return listeners;
+  }
   shouldFake(event) {
     if (matchesAny(event, this.eventsToDispatch)) return false;
     return this.eventsToFake.length === 0 || matchesAny(event, this.eventsToFake);
@@ -5868,10 +6091,10 @@ var BusFake = class _BusFake {
   /** The rest of the chain, by the first job (Bus.chain([a, b, c]) records a with [b, c]). */
   chains = /* @__PURE__ */ new Map();
   static fake(jobsToFake = []) {
-    return install(BusDispatcher, new _BusFake(_BusFake.original(), [jobsToFake].flat()));
+    return install2(BusDispatcher, new _BusFake(_BusFake.original(), [jobsToFake].flat()));
   }
   static fakeExcept(jobsToDispatch) {
-    return install(BusDispatcher, new _BusFake(_BusFake.original(), [], [jobsToDispatch].flat()));
+    return install2(BusDispatcher, new _BusFake(_BusFake.original(), [], [jobsToDispatch].flat()));
   }
   static original() {
     const current = bound(BusDispatcher);
@@ -6076,10 +6299,10 @@ var QueueFake = class _QueueFake {
   jobsToPush;
   jobs = [];
   static fake(jobsToFake = []) {
-    return install(QueueManager, new _QueueFake(_QueueFake.original(), [jobsToFake].flat()));
+    return install2(QueueManager, new _QueueFake(_QueueFake.original(), [jobsToFake].flat()));
   }
   static fakeExcept(jobsToPush) {
-    return install(QueueManager, new _QueueFake(_QueueFake.original(), [], [jobsToPush].flat()));
+    return install2(QueueManager, new _QueueFake(_QueueFake.original(), [], [jobsToPush].flat()));
   }
   static original() {
     const current = bound(QueueManager);
@@ -6258,13 +6481,14 @@ var MailFake = class _MailFake {
   records = [];
   static fake() {
     const current = bound(MailManager);
-    return install(MailManager, new _MailFake(current instanceof _MailFake ? current.manager : current));
+    return install2(MailManager, new _MailFake(current instanceof _MailFake ? current.manager : current));
   }
   // MailManager ----------------------------------------------------------------------------------------------
   mailer(name) {
     return {
       to: (recipients) => this.pending(name, recipients),
       send: (mailable) => this.sendVia(name, mailable, empty()),
+      sendNow: (mailable) => this.sendNowVia(name, mailable, empty()),
       queue: (mailable) => this.queueVia(name, mailable, empty(), void 0)
     };
   }
@@ -6274,6 +6498,10 @@ var MailFake = class _MailFake {
   send(mailable) {
     return this.sendVia(void 0, mailable, empty());
   }
+  /** Recorded as sent, never queued, like the real sendNow(). */
+  sendNow(mailable) {
+    return this.sendNowVia(void 0, mailable, empty());
+  }
   queue(mailable) {
     return this.queueVia(void 0, mailable, empty(), void 0);
   }
@@ -6357,6 +6585,7 @@ var MailFake = class _MailFake {
         return pending;
       },
       send: (mailable) => this.sendVia(mailer, mailable, overrides),
+      sendNow: (mailable) => this.sendNowVia(mailer, mailable, overrides),
       queue: (mailable) => this.queueVia(mailer, mailable, overrides, void 0),
       later: (delay, mailable) => this.queueVia(mailer, mailable, overrides, delay)
     };
@@ -6366,6 +6595,10 @@ var MailFake = class _MailFake {
     await this.record(mailer, mailable, overrides, isQueueable(mailable), void 0);
     return void 0;
   }
+  async sendNowVia(mailer, mailable, overrides) {
+    await this.record(mailer, mailable, overrides, false, void 0);
+    return void 0;
+  }
   async queueVia(mailer, mailable, overrides, delay) {
     await this.record(mailer, mailable, overrides, true, delay);
   }
@@ -6436,7 +6669,7 @@ var NotificationFake = class _NotificationFake {
   notifications = [];
   static fake() {
     const current = bound(NotificationDispatcher);
-    return install(NotificationDispatcher, new _NotificationFake(current instanceof _NotificationFake ? current.dispatcher : current));
+    return install2(NotificationDispatcher, new _NotificationFake(current instanceof _NotificationFake ? current.dispatcher : current));
   }
   // NotificationDispatcher -------------------------------------------------------------------------------------
   async send(notifiables, notification) {
@@ -6799,7 +7032,7 @@ var StorageFake = class _StorageFake {
   static fake(disk) {
     const current = bound(FilesystemManager);
     const config = bound(ConfigRepository);
-    const fake = current instanceof _StorageFake ? current : install(FilesystemManager, new _StorageFake(current, config?.get("filesystems.default", "local") ?? "local"));
+    const fake = current instanceof _StorageFake ? current : install2(FilesystemManager, new _StorageFake(current, config?.get("filesystems.default", "local") ?? "local"));
     const name = disk ?? fake.defaultDisk;
     const faked = new FakeDisk(name);
     fake.disks.set(name, faked);
@@ -7187,18 +7420,18 @@ export {
   addApiRouting,
   registerHttpCommands,
   HttpServiceProvider,
-  On,
-  Locked,
-  Computed,
-  ErrorBag,
-  PendingEvent,
-  Component,
   LiveError,
   CorruptComponentPayloadError,
   MethodNotCallableError,
   PropertyNotUpdatableError,
   LiveComponentNotFoundError,
   InvalidLiveRequestError,
+  On,
+  Locked,
+  Computed,
+  ErrorBag,
+  PendingEvent,
+  Component,
   TestRequestScope,
   Testable,
   live,
@@ -7211,6 +7444,12 @@ export {
   UPDATE_URI,
   LiveServiceProvider,
   Pagination,
+  travelTo,
+  travelBack,
+  freezeTime,
+  freezeSecond,
+  travel,
+  Wormhole,
   PendingCommand,
   RefreshDatabaseState,
   runCommand,
@@ -7239,8 +7478,9 @@ export {
   MakesHttpRequests,
   InteractsWithDatabase,
   InteractsWithConsole,
+  InteractsWithTime,
   TestCase,
-  install,
+  install2,
   nameOf,
   matches,
   EventFake,
@@ -7256,4 +7496,4 @@ export {
   StorageFake,
   FakeFile
 };
-//# sourceMappingURL=chunk-WNJP46B7.js.map
+//# sourceMappingURL=chunk-ZOEPKBVF.js.map