@bunyad/orm 0.1.0-alpha.0 → 0.2.0-beta.1

package/dist/model.d.ts

@@ -1,6 +1,6 @@
 import type { Connection, DatabaseManager, DateInput } from "@bunyad/database";
 import { LengthAwarePaginator, CursorPaginator } from "@bunyad/database";
-import { Collection } from "@bunyad/common";
+import { Collection, LazyCollection } from "@bunyad/common";
 import { OrmCollection } from "./orm-collection.js";
 import { type CastDefinition } from "./casts.js";
 import { type ModelEventListener, type ModelEventName, type ModelObserver } from "./model-events.js";
@@ -81,7 +81,7 @@ export declare class Model {
     /** When false, `save()` skips `created_at` / `updated_at`. */
     static timestamps: boolean;
     /**
-     * Laravel `$casts` property — prefer `static casts()` when adding enums / Attribute.
+     * `$casts` property — prefer `static casts()` when adding enums / Attribute.
      * May be a plain object or a method returning the map.
      */
     static casts: Record<string, CastDefinition> | (() => Record<string, CastDefinition>);
@@ -92,22 +92,22 @@ export declare class Model {
      */
     static relations: RelationsMap;
     /**
-     * Laravel `$touches` — relation names whose related models get `touch()` after
+     * `$touches` — relation names whose related models get `touch()` after
      * this model is saved (or soft-deleted). Honor `withoutTouching`.
      */
     static touches: string[];
-    /** Laravel `$hidden`. */
+    /** `$hidden`. */
     static hidden: string[];
-    /** Laravel `$visible` allow-list (empty = all non-hidden). */
+    /** `$visible` allow-list (empty = all non-hidden). */
     static visible: string[];
-    /** Laravel `$appends` — accessors included in `toArray()`. */
+    /** `$appends` — accessors included in `toArray()`. */
     static appends: string[];
-    /** Laravel `$fillable`. */
+    /** `$fillable`. */
     static fillable: readonly string[] | string[];
-    /** Laravel `$guarded` — default guard all until fillable is set. */
+    /** `$guarded` — default guard all until fillable is set. */
     static guarded: readonly string[] | string[];
     id: string | number;
-    /** Laravel `$exists` — true after retrieve / successful insert. */
+    /** `$exists` — true after retrieve / successful insert. */
     get exists(): boolean;
     set exists(value: boolean);
     constructor(attributes?: Record<string, unknown>);
@@ -121,81 +121,81 @@ export declare class Model {
     /** Current attribute bag (non-function own properties). */
     getAttributes(): Record<string, unknown>;
     /**
-     * Laravel `getAttribute` — throws when `preventAccessingMissingAttributes` is on
+     * `getAttribute` — throws when `preventAccessingMissingAttributes` is on
      * and the key was not retrieved / does not exist (relations exempt).
      */
     getAttribute(key: string): unknown;
-    /** Laravel `isDirty`. */
+    /** `isDirty`. */
     isDirty(...attributes: string[]): boolean;
-    /** Laravel `isClean`. */
+    /** `isClean`. */
     isClean(...attributes: string[]): boolean;
-    /** Laravel `getDirty`. */
+    /** `getDirty`. */
     getDirty(): Record<string, unknown>;
-    /** Laravel `getOriginal`. */
+    /** `getOriginal`. */
     getOriginal(): Record<string, unknown>;
     getOriginal(key: string): unknown;
-    /** Laravel `getChanges` — attributes changed by the last save. */
+    /** `getChanges` — attributes changed by the last save. */
     getChanges(): Record<string, unknown>;
-    /** Laravel `wasChanged`. */
+    /** `wasChanged`. */
     wasChanged(...attributes: string[]): boolean;
-    /** Laravel `wasRecentlyCreated`. */
+    /** `wasRecentlyCreated`. */
     wasRecentlyCreated(): boolean;
-    /** Laravel `append`. */
+    /** `append`. */
     append(...attributes: string[]): this;
-    /** Laravel `setAppends`. */
+    /** `setAppends`. */
     setAppends(attributes: string[]): this;
-    /** Laravel `getAppends`. */
+    /** `getAppends`. */
     getAppends(): string[];
-    /** Laravel `getHidden`. */
+    /** `getHidden`. */
     getHidden(): string[];
-    /** Laravel `getVisible`. */
+    /** `getVisible`. */
     getVisible(): string[];
-    /** Laravel `setHidden`. */
+    /** `setHidden`. */
     setHidden(attributes: string[]): this;
-    /** Laravel `setVisible`. */
+    /** `setVisible`. */
     setVisible(attributes: string[]): this;
-    /** Laravel `makeVisible` — show attributes for this instance. */
+    /** `makeVisible` — show attributes for this instance. */
     makeVisible(...attributes: string[]): this;
-    /** Laravel `makeHidden` — hide attributes for this instance. */
+    /** `makeHidden` — hide attributes for this instance. */
     makeHidden(...attributes: string[]): this;
     /**
-     * Run a callback without touching timestamps (Laravel `Model::withoutTimestamps`).
+     * Run a callback without touching timestamps (`Model::withoutTimestamps`).
      */
     static withoutTimestamps<T>(this: typeof Model, callback: () => T | Promise<T>): Promise<T>;
     /**
-     * Laravel `Model::withoutTouching` — skip parent `touch()` while callback runs.
+     * `Model::withoutTouching` — skip parent `touch()` while callback runs.
      * Pass model classes to limit which models ignore touch; omit for all.
      */
     static withoutTouching<T>(this: typeof Model, callback: () => T | Promise<T>): Promise<T>;
     static withoutTouching<T>(this: typeof Model, models: Array<typeof Model>, callback: () => T | Promise<T>): Promise<T>;
     /** Whether touch is currently suppressed for this model class. */
     static isIgnoringTouch(this: typeof Model): boolean;
-    /** Laravel `Model::preventLazyLoading`. */
+    /** `Model::preventLazyLoading`. */
     static preventLazyLoading(prevent?: boolean): void;
-    /** Laravel `Model::preventSilentlyDiscardingAttributes`. */
+    /** `Model::preventSilentlyDiscardingAttributes`. */
     static preventSilentlyDiscardingAttributes(prevent?: boolean): void;
-    /** Laravel `Model::preventAccessingMissingAttributes`. */
+    /** `Model::preventAccessingMissingAttributes`. */
     static preventAccessingMissingAttributes(prevent?: boolean): void;
-    /** Laravel `Model::shouldBeStrict` — enable/disable the strictness trio. */
+    /** `Model::shouldBeStrict` — enable/disable the strictness trio. */
     static shouldBeStrict(should?: boolean): void;
-    /** Laravel `Model::addGlobalScope`. */
+    /** `Model::addGlobalScope`. */
     static addGlobalScope(this: typeof Model, nameOrScope: string | GlobalScopeCallback, scope?: GlobalScopeCallback): void;
-    /** Laravel `Model::addGlobalScope` removal helper. */
+    /** `Model::addGlobalScope` removal helper. */
     static removeGlobalScope(this: typeof Model, name: string): void;
     /**
-     * Laravel `boot` — runs once per model class before first use.
+     * `boot` — runs once per model class before first use.
      * Prefer registering listeners in `booted()`.
      */
     static boot(): void;
     /**
-     * Laravel `booted` — runs once after `boot`. Typical place for `static::created(...)`.
+     * `booted` — runs once after `boot`. Typical place for `static::created(...)`.
      */
     static booted(): void;
     /** Ensure this model class has been booted. */
     static bootIfNotBooted(): void;
-    /** Laravel `Model::observe`. */
+    /** `Model::observe`. */
     static observe<T extends Model>(this: abstract new (...args: never[]) => T, observer: ModelObserver<T> | (new () => ModelObserver<T>) | Array<ModelObserver<T> | (new () => ModelObserver<T>)>): void;
-    /** Laravel `Model::withoutEvents`. */
+    /** `Model::withoutEvents`. */
     static withoutEvents<T>(this: typeof Model, callback: () => T | Promise<T>): T | Promise<T>;
     static retrieved(callback: ModelEventListener): void;
     static creating(callback: ModelEventListener): void;
@@ -219,13 +219,13 @@ export declare class Model {
     static castAttributes(attributes: Record<string, unknown>, direction: "get" | "set"): Record<string, unknown>;
     static setConnection(connection: Connection): void;
     static getConnection(): Connection;
-    /** Laravel `$model->setConnection($name)`. */
+    /** `$model->setConnection($name)`. */
     setConnection(connection: string | Connection): this;
     /** Active connection for this instance (instance override → model → default). */
     getConnection(): Connection;
     static db(): DatabaseManager;
     /**
-     * Laravel `Model::on($connection)` — same model, different named connection.
+     * `Model::on($connection)` — same model, different named connection.
      */
     static on<T extends typeof Model>(this: T, connection: string): ModelQuery<InstanceType<T>>;
     /**
@@ -233,37 +233,37 @@ export declare class Model {
      * Local scopes (`scopeActive` → `.active()`) are available via proxy.
      */
     static newQuery<T extends typeof Model>(this: T, options?: ModelQueryOptions): ModelQuery<InstanceType<T>>;
-    /** Laravel `withoutGlobalScopes()`. */
+    /** `withoutGlobalScopes()`. */
     static withoutGlobalScopes<T extends typeof Model>(this: T, names?: string[]): ModelQuery<InstanceType<T>>;
-    /** Laravel `withoutGlobalScope($name)`. */
+    /** `withoutGlobalScope($name)`. */
     static withoutGlobalScope<T extends typeof Model>(this: T, name: string): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::query()` — scoped `ModelQuery` (not a raw table builder). */
+    /** `Model::query()` — scoped `ModelQuery` (not a raw table builder). */
     static query<T extends typeof Model>(this: T, options?: ModelQueryOptions): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::find`. */
+    /** `Model::find`. */
     static find<T extends typeof Model>(this: T, id: string | number): InstanceType<T> | null | Promise<InstanceType<T> | null>;
-    /** Laravel `getRouteKeyName()` — column used for implicit route binding. */
+    /** `getRouteKeyName()` — column used for implicit route binding. */
     static getRouteKeyName(): string;
     /**
-     * Laravel `resolveRouteBinding` — find by PK or custom `{param:column}` field.
+     * `resolveRouteBinding` — find by PK or custom `{param:column}` field.
      */
     static resolveRouteBinding<T extends typeof Model>(this: T, value: string | number, field?: string): InstanceType<T> | null | Promise<InstanceType<T> | null>;
     /**
-     * Laravel SoftDeletes `resolveSoftDeletableRouteBinding` — same as
+     * `resolveSoftDeletableRouteBinding` — same as
      * `resolveRouteBinding` but includes soft-deleted rows (`withTrashed()`).
      * Used by the router when the route opts in via `withTrashed()`.
      */
     static resolveSoftDeletableRouteBinding<T extends typeof Model>(this: T, value: string | number, field?: string): InstanceType<T> | null | Promise<InstanceType<T> | null>;
-    /** Laravel `Model::findOrFail`. */
+    /** `Model::findOrFail`. */
     static findOrFail<T extends typeof Model>(this: T, id: string | number): Promise<InstanceType<T>>;
-    /** Laravel `Model::all`. */
+    /** `Model::all`. */
     static all<T extends typeof Model>(this: T): Promise<OrmCollection<InstanceType<T>>>;
     /**
-     * Laravel `Model::get` — same as `query().get()` / `all()`.
+     * `Model::get` — same as `query().get()` / `all()`.
      * Typed helper for autocomplete; Proxy also forwards other terminals.
      */
     static get<T extends typeof Model>(this: T): OrmCollection<InstanceType<T>> | Promise<OrmCollection<InstanceType<T>>>;
     /**
-     * Laravel `Model::pluck($column, $key = null)`.
+     * `Model::pluck($column, $key = null)`.
      * One column → list Collection; with `key` → keyed Record (see Collection.pluck).
      */
     static pluck<T extends typeof Model>(this: T, column: string): Promise<Collection<unknown>>;
@@ -272,13 +272,13 @@ export declare class Model {
     static allSync<T extends typeof Model>(this: T): OrmCollection<InstanceType<T>>;
     /** SQLite-only sync `find` — see `ModelQuery.firstSync`. */
     static findSync<T extends typeof Model>(this: T, id: string | number): InstanceType<T> | null;
-    /** Laravel `Model::where`. */
+    /** `Model::where`. */
     static where<T extends typeof Model>(this: T, callback: (query: ModelQuery<InstanceType<T>>) => void): ModelQuery<InstanceType<T>>;
     static where<T extends typeof Model>(this: T, column: string, value: unknown): ModelQuery<InstanceType<T>>;
     static where<T extends typeof Model>(this: T, column: string, op: string, value: unknown): ModelQuery<InstanceType<T>>;
     /** Karobar-style multi-column LIKE search. */
     static search<T extends typeof Model>(this: T, columns: string[], term: string): ModelQuery<InstanceType<T>>;
-    /** Start a new query and forward common builder methods (Laravel `__callStatic`). */
+    /** Start a new query and forward common builder methods (`__callStatic`). */
     static orWhere<T extends typeof Model>(this: T, column: string, value: unknown): ModelQuery<InstanceType<T>>;
     static orWhere<T extends typeof Model>(this: T, column: string, op: string, value: unknown): ModelQuery<InstanceType<T>>;
     static whereIn<T extends typeof Model>(this: T, column: string, values: unknown[]): ModelQuery<InstanceType<T>>;
@@ -294,36 +294,36 @@ export declare class Model {
     static limit<T extends typeof Model>(this: T, value: number): ModelQuery<InstanceType<T>>;
     static take<T extends typeof Model>(this: T, value: number): ModelQuery<InstanceType<T>>;
     static select<T extends typeof Model>(this: T, ...columns: string[]): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereDate`. */
+    /** `Model::whereDate`. */
     static whereDate<T extends typeof Model>(this: T, column: string, value: DateInput): ModelQuery<InstanceType<T>>;
     static whereDate<T extends typeof Model>(this: T, column: string, op: string, value: DateInput): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereNot(closure)`. */
+    /** `Model::whereNot(closure)`. */
     static whereNot<T extends typeof Model>(this: T, callback: (query: ModelQuery<InstanceType<T>>) => void): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::orWhereNot(closure)`. */
+    /** `Model::orWhereNot(closure)`. */
     static orWhereNot<T extends typeof Model>(this: T, callback: (query: ModelQuery<InstanceType<T>>) => void): ModelQuery<InstanceType<T>>;
-    /** Laravel `withTrashed()`. */
+    /** `withTrashed()`. */
     static withTrashed<T extends typeof Model>(this: T): ModelQuery<InstanceType<T>>;
-    /** Laravel `onlyTrashed()`. */
+    /** `onlyTrashed()`. */
     static onlyTrashed<T extends typeof Model>(this: T): ModelQuery<InstanceType<T>>;
-    /** Laravel `withoutTrashed()`. */
+    /** `withoutTrashed()`. */
     static withoutTrashed<T extends typeof Model>(this: T): ModelQuery<InstanceType<T>>;
     /** `get()` returns plain row objects. Models are not built. */
     static rows<T extends typeof Model>(this: T): ModelQuery<InstanceType<T>, "row">;
     /** Eager-load relations (`with('posts')`, `with({ posts: (q) => q.where(…) })`). */
     static with<T extends typeof Model>(this: T, ...relations: Array<string | string[] | Record<string, unknown>>): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereHas`. */
+    /** `Model::whereHas`. */
     static whereHas<T extends typeof Model>(this: T, relation: string, callback?: (query: ModelQuery) => void): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereDoesntHave`. */
+    /** `Model::whereDoesntHave`. */
     static whereDoesntHave<T extends typeof Model>(this: T, relation: string, callback?: (query: ModelQuery) => void): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::orWhereHas`. */
+    /** `Model::orWhereHas`. */
     static orWhereHas<T extends typeof Model>(this: T, relation: string, callback?: (query: ModelQuery) => void): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereRelation`. */
+    /** `Model::whereRelation`. */
     static whereRelation<T extends typeof Model>(this: T, relation: string, column: string, opOrValue: unknown, value?: unknown): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::orWhereRelation`. */
+    /** `Model::orWhereRelation`. */
     static orWhereRelation<T extends typeof Model>(this: T, relation: string, column: string, opOrValue: unknown, value?: unknown): ModelQuery<InstanceType<T>>;
     /** `withCount` — `'posts'`, `'posts as post_total'`, a string list, or `{ products: { as: 'productsCount' } }`. */
     static withCount<T extends typeof Model>(this: T, ...relations: Array<string | string[] | Record<string, unknown>>): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::withSum`. */
+    /** `Model::withSum`. */
     static withSum<T extends typeof Model>(this: T, relation: string, column: string): ModelQuery<InstanceType<T>>;
     static withAvg<T extends typeof Model>(this: T, relation: string, column: string): ModelQuery<InstanceType<T>>;
     static withMin<T extends typeof Model>(this: T, relation: string, column: string): ModelQuery<InstanceType<T>>;
@@ -335,33 +335,41 @@ export declare class Model {
     static whereAll<T extends typeof Model>(this: T, columns: string[], opOrValue: unknown, value?: unknown): ModelQuery<InstanceType<T>>;
     static whereNone<T extends typeof Model>(this: T, columns: string[], opOrValue: unknown, value?: unknown): ModelQuery<InstanceType<T>>;
     static whereKey<T extends typeof Model>(this: T, id: string | number | Array<string | number>): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereUuid`. */
+    /** `Model::whereUuid`. */
     static whereUuid<T extends typeof Model>(this: T, column: string, value: string): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::whereUlid`. */
+    /** `Model::whereUlid`. */
     static whereUlid<T extends typeof Model>(this: T, column: string, value: string): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::join`. */
+    /** `Model::join`. */
     static join<T extends typeof Model>(this: T, table: string, first: string, op: string, second: string): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::leftJoin`. */
+    /** `Model::leftJoin`. */
     static leftJoin<T extends typeof Model>(this: T, table: string, first: string, op: string, second: string): ModelQuery<InstanceType<T>>;
-    /** Laravel `Model::paginate`. */
+    /** `Model::paginate`. */
     static paginate<T extends typeof Model>(this: T, perPage?: number, page?: number, options?: {
         path?: string;
         pageName?: string;
     }): Promise<LengthAwarePaginator<InstanceType<T>>>;
-    /** Laravel `Model::cursorPaginate`. */
+    /** `Model::cursorPaginate`. */
     static cursorPaginate<T extends typeof Model>(this: T, perPage?: number, cursor?: string | null, options?: {
         path?: string;
         cursorName?: string;
     }): Promise<CursorPaginator<InstanceType<T>>>;
-    /** Laravel `Model::create` (respects `$fillable` / `$guarded`). */
+    /** `Model::cursor()`: stream models from a single query. */
+    static cursor<T extends typeof Model>(this: T, chunkSize?: number): LazyCollection<InstanceType<T>>;
+    /** `Model::lazy()`: chunked iteration, one query per chunk. */
+    static lazy<T extends typeof Model>(this: T, chunkSize?: number): LazyCollection<InstanceType<T>>;
+    /** `Model::lazyById()`: chunked iteration by primary key (safe while updating). */
+    static lazyById<T extends typeof Model>(this: T, chunkSize?: number, column?: string): LazyCollection<InstanceType<T>>;
+    /** `Model::lazyByIdDesc()`. */
+    static lazyByIdDesc<T extends typeof Model>(this: T, chunkSize?: number, column?: string): LazyCollection<InstanceType<T>>;
+    /** `Model::create` (respects `$fillable` / `$guarded`). */
     static create<T extends typeof Model>(this: T, attributes: Record<string, unknown>): InstanceType<T> | Promise<InstanceType<T>>;
-    /** Laravel `Model::forceCreate` — insert every given attribute, ignoring `$fillable`. */
+    /** `Model::forceCreate` — insert every given attribute, ignoring `$fillable`. */
     static forceCreate<T extends typeof Model>(this: T, useAttrs: Record<string, unknown>): InstanceType<T> | Promise<InstanceType<T>>;
-    /** Laravel `firstOrNew`. */
+    /** `firstOrNew`. */
     static firstOrNew<T extends typeof Model>(this: T, attributes: Record<string, unknown>, values?: Record<string, unknown>): Promise<InstanceType<T>>;
-    /** Laravel `firstOrCreate`. */
+    /** `firstOrCreate`. */
     static firstOrCreate<T extends typeof Model>(this: T, attributes: Record<string, unknown>, values?: Record<string, unknown>): Promise<InstanceType<T>>;
-    /** Laravel `updateOrCreate`. */
+    /** `updateOrCreate`. */
     static updateOrCreate<T extends typeof Model>(this: T, attributes: Record<string, unknown>, values?: Record<string, unknown>): Promise<InstanceType<T>>;
     /**
      * Bulk insert. Delegates to `ModelQuery.insert` (timestamps stamped when enabled).
@@ -369,49 +377,49 @@ export declare class Model {
      */
     static insert<T extends typeof Model>(this: T, values: Record<string, unknown> | Record<string, unknown>[]): Promise<boolean>;
     /**
-     * Laravel `Model::upsert` — bulk insert-or-update on unique conflict.
+     * `Model::upsert` — bulk insert-or-update on unique conflict.
      * Delegates to `ModelQuery.upsert` (timestamps stamped when enabled).
      */
     static upsert<T extends typeof Model>(this: T, values: Record<string, unknown> | Record<string, unknown>[], uniqueBy: string | string[], update?: string[] | null): Promise<number>;
-    /** Laravel `$model->fill($attributes)`. */
+    /** `$model->fill($attributes)`. */
     fill(attributes: Record<string, unknown>): this;
-    /** Laravel `$model->update($attributes)`. */
+    /** `$model->update($attributes)`. */
     update(attributes: Record<string, unknown>): Promise<this>;
     save(): this | Promise<this>;
-    /** Laravel `$model->saveQuietly()`. */
+    /** `$model->saveQuietly()`. */
     saveQuietly(): Promise<this>;
-    /** Laravel `$model->refresh()`. */
+    /** `$model->refresh()`. */
     refresh(): Promise<this>;
     /**
-     * Laravel-style refresh under row lock (`lockForUpdate`).
+     * Refresh under row lock (`lockForUpdate`).
      * Reloads this instance from a locked select of the same primary key.
      */
     refreshForUpdate(): Promise<this>;
-    /** Laravel `$model->fresh()`. */
+    /** `$model->fresh()`. */
     fresh(): Promise<this | null>;
     /** Eager-load relations onto this model (`load('posts')` / constrained maps). */
     load(...relations: Array<string | Record<string, unknown>>): Promise<this>;
     /** Load only relations that are not already present. */
     loadMissing(...relations: Array<string | Record<string, unknown>>): Promise<this>;
-    /** Laravel `$model->relationLoaded($key)`. */
+    /** `$model->relationLoaded($key)`. */
     relationLoaded(key: string): boolean;
     /**
-     * Laravel `$model->touches($relation)` — whether `$touches` lists this relation.
+     * `$model->touches($relation)` — whether `$touches` lists this relation.
      */
     touches(relation: string): boolean;
     /**
-     * Laravel `$model->touchOwners()` — touch each relation in `$touches`.
+     * `$model->touchOwners()` — touch each relation in `$touches`.
      * Uses `relation.touch()` when available (BelongsTo / HasOne / HasMany);
      * otherwise loads the related model and calls `touch()` on it.
      */
     touchOwners(): Promise<void>;
     /**
-     * Laravel `$model->touch()` — bump `updated_at` (no-op while `withoutTouching`).
+     * `$model->touch()` — bump `updated_at` (no-op while `withoutTouching`).
      * Saving also runs `$touches` / `touchOwners()` for listed relations.
      */
     touch(): Promise<boolean>;
     /**
-     * Relation query builder (`$model->product()` in Laravel).
+     * Relation query builder (`$model->product()`).
      *
      * Define relations on `static relations` and declare the loaded property:
      * `declare product: Product | null` — then use `model.product` after `with('product')`,
@@ -420,66 +428,66 @@ export declare class Model {
      * Legacy instance methods named `product()` remain supported via the prototype.
      */
     related(name: string): unknown;
-    /** Laravel `$model->replicate()`. */
+    /** `$model->replicate()`. */
     replicate(except?: string[]): this;
     delete(): Promise<void>;
     restore(): Promise<void>;
     forceDelete(): Promise<void>;
-    /** Laravel `$model->deleteQuietly()`. */
+    /** `$model->deleteQuietly()`. */
     deleteQuietly(): Promise<void>;
     trashed(): boolean;
-    /** Laravel `$model->toArray()`. */
+    /** `$model->toArray()`. */
     toArray(): Record<string, unknown>;
-    /** Laravel `$model->loadCount(...$relations)`. */
+    /** `$model->loadCount(...$relations)`. */
     loadCount(...relations: string[]): Promise<this>;
-    /** Laravel `$model->loadSum($relation, $column)`. */
+    /** `$model->loadSum($relation, $column)`. */
     loadSum(relation: string, column: string): Promise<this>;
     loadAvg(relation: string, column: string): Promise<this>;
     loadMin(relation: string, column: string): Promise<this>;
     loadMax(relation: string, column: string): Promise<this>;
-    /** Laravel `$model->loadExists(...$relations)`. */
+    /** `$model->loadExists(...$relations)`. */
     loadExists(...relations: string[]): Promise<this>;
     toJSON(): Record<string, unknown>;
     /** Alias of {@link toJSON}. */
     toJson(): Record<string, unknown>;
-    /** Laravel `$model->increment($column, $amount)`. */
+    /** `$model->increment($column, $amount)`. */
     increment(column: string, amount?: number): Promise<this>;
-    /** Laravel `$model->decrement($column, $amount)`. */
+    /** `$model->decrement($column, $amount)`. */
     decrement(column: string, amount?: number): Promise<this>;
-    /** Laravel `Model::destroy($ids)`. */
+    /** `Model::destroy($ids)`. */
     static destroy<T extends typeof Model>(this: T, ids: Array<string | number> | string | number): Promise<number>;
     /**
-     * Laravel `Model::forceDestroy($ids)` — permanent delete by key(s).
+     * `Model::forceDestroy($ids)` — permanent delete by key(s).
      * Soft-delete models are found via `withTrashed()` so trashed rows are included.
      */
     static forceDestroy<T extends typeof Model>(this: T, ids: Array<string | number> | string | number): Promise<number>;
-    /** Laravel `$this->hasMany(Related::class)`. */
+    /** `$this->hasMany(Related::class)`. */
     hasMany<R extends ModelClass>(related: R, foreignKey?: string, localKey?: string): HasMany<InstanceType<R>>;
-    /** Laravel `$this->hasOne(Related::class)`. */
+    /** `$this->hasOne(Related::class)`. */
     hasOne<R extends ModelClass>(related: R, foreignKey?: string, localKey?: string): HasOne<InstanceType<R>>;
     /**
-     * Laravel `$this->hasManyThrough(Related::class, Through::class)`.
+     * `$this->hasManyThrough(Related::class, Through::class)`.
      * Parent → Through (firstKey) → Related (secondKey).
      */
     hasManyThrough<R extends ModelClass, TThrough extends ModelClass>(related: R, through: TThrough, firstKey?: string, secondKey?: string, localKey?: string, secondLocalKey?: string): HasManyThrough<InstanceType<R>>;
     /**
-     * Laravel `$this->hasOneThrough(Related::class, Through::class)`.
+     * `$this->hasOneThrough(Related::class, Through::class)`.
      */
     hasOneThrough<R extends ModelClass, TThrough extends ModelClass>(related: R, through: TThrough, firstKey?: string, secondKey?: string, localKey?: string, secondLocalKey?: string): HasOneThrough<InstanceType<R>>;
-    /** Laravel `$this->belongsTo(Related::class)`. */
+    /** `$this->belongsTo(Related::class)`. */
     belongsTo<R extends ModelClass>(related: R, foreignKey?: string, ownerKey?: string): BelongsTo<InstanceType<R>>;
-    /** Laravel `$this->belongsToMany(Related::class, pivot)`. */
+    /** `$this->belongsToMany(Related::class, pivot)`. */
     belongsToMany<R extends ModelClass>(related: R, table?: string, foreignPivotKey?: string, relatedPivotKey?: string): BelongsToMany<InstanceType<R>>;
     /**
      * Polymorphic many-to-many (`model_has_roles`-style pivots).
      * Third argument may be the pivot table name or an options bag (tenant/legacy morph types).
      */
     morphToMany<R extends ModelClass>(related: R, name: string, tableOrOptions?: string | MorphToManyOptions, foreignPivotKey?: string, relatedPivotKey?: string): MorphToMany<InstanceType<R>>;
-    /** Laravel `$this->morphMany(Related::class, name)`. */
+    /** `$this->morphMany(Related::class, name)`. */
     morphMany<R extends ModelClass>(related: R, name: string, type?: string, id?: string, localKey?: string): MorphMany<InstanceType<R>>;
-    /** Laravel `$this->morphOne(Related::class, name)`. */
+    /** `$this->morphOne(Related::class, name)`. */
     morphOne<R extends ModelClass>(related: R, name: string, type?: string, id?: string, localKey?: string): MorphOne<InstanceType<R>>;
-    /** Laravel `$this->morphTo($name)`. */
+    /** `$this->morphTo($name)`. */
     morphTo(name: string, type?: string, id?: string, ownerKey?: string): MorphTo;
 }
 /** True when `value` is a Model subclass constructor (O(1) prototype check). */