chore(patterns): Deprecate "sloppy" interface guard option

Author: rekmarks

packages/patterns/NEWS.md

@@ -1,5 +1,9 @@
 User-visible changes in `@endo/patterns`:
 
+# Next release
+
+- The `sloppy` option for `@endo/patterns` interface guards is deprecated. Use `defaultGuards` instead.
+
 # 1.7.0 (2025-07-11)
 
 - `@endo/marshal` introduces an environment variable config option `ENDO_RANK_STRINGS` to change the rank ordering of strings from the current (incorrect) ordering by UTF-16 code unit used by JavaScript's `<` and `.sort()` operations to (correct and OCapN-conformant) ordering by Unicode code point. It currently defaults to "utf16-code-unit-order", matching the previously-unconditional behavior.

packages/patterns/src/types.ts

@@ -558,16 +558,29 @@ export type MakeInterfaceGuardStrict = <
 >(
   interfaceName: string,
   methodGuards: M,
-  options: { defaultGuards?: undefined; sloppy?: false },
+  options: {
+    defaultGuards?: undefined;
+    /**
+     * @deprecated This has no effect.
+     */
+    sloppy?: false;
+  },
 ) => InterfaceGuard<M>;
 
 /**
  * Overload for sloppy interface guards (looser typing).
+ * @deprecated Use {@link MakeInterfaceGuardStrict} or {@link MakeInterfaceGuardGeneral} instead.
  */
 export type MakeInterfaceGuardSloppy = (
   interfaceName: string,
   methodGuards: any,
-  options: { defaultGuards?: 'passable' | 'raw'; sloppy?: true },
+  options: {
+    defaultGuards?: 'passable' | 'raw';
+    /**
+     * @deprecated Use `defaultGuards: undefined` instead.
+     */
+    sloppy?: true;
+  },
 ) => InterfaceGuard<any>;
 
 /**
@@ -578,7 +591,13 @@ export type MakeInterfaceGuardGeneral = <
 >(
   interfaceName: string,
   methodGuards: M,
-  options?: { defaultGuards?: DefaultGuardType; sloppy?: boolean },
+  options?: {
+    defaultGuards?: DefaultGuardType;
+    /**
+     * @deprecated Use `defaultGuards` instead.
+     */
+    sloppy?: boolean;
+  },
 ) => InterfaceGuard<M>;
 
 /**
@@ -657,6 +676,9 @@ export type InterfaceGuardPayload<
     T[Extract<keyof T, symbol>]
   >;
   defaultGuards?: DefaultGuardType;
+  /**
+   * @deprecated Use `defaultGuards` instead.
+   */
   sloppy?: boolean;
 };