From bf4a71a0a9507a79ac4a5fabdd190fc4eb442a55 Mon Sep 17 00:00:00 2001
From: "Mark S. Miller" <erights@gmail.com>
Date: Wed, 31 Aug 2022 22:08:51 -0700
Subject: [PATCH] fix: deprecate kinds in favor of far classes

---
 packages/vat-data/src/types.d.ts | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/vat-data/src/types.d.ts b/packages/vat-data/src/types.d.ts
index ec9291de68c9..cf5ed65741db 100644
--- a/packages/vat-data/src/types.d.ts
+++ b/packages/vat-data/src/types.d.ts
@@ -96,12 +96,15 @@ type DefineKindOptions<C> = {
 
 export type VatData = {
   // virtual kinds
+  /** @deprecated Use defineVirtualFarClass instead */
   defineKind: <P, S, F>(
     tag: string,
     init: (...args: P) => S,
     facet: F,
     options?: DefineKindOptions<KindContext<S, F>>,
   ) => (...args: P) => KindFacet<F>;
+
+  /** @deprecated Use defineVirtualFarClassKit instead */
   defineKindMulti: <P, S, B>(
     tag: string,
     init: (...args: P) => S,
@@ -111,12 +114,16 @@ export type VatData = {
 
   // durable kinds
   makeKindHandle: (descriptionTag: string) => DurableKindHandle;
+
+  /** @deprecated Use defineDurableFarClass instead */
   defineDurableKind: <P, S, F>(
     kindHandle: DurableKindHandle,
     init: (...args: P) => S,
     facet: F,
     options?: DefineKindOptions<KindContext<S, F>>,
   ) => (...args: P) => KindFacet<F>;
+
+  /** @deprecated Use defineDurableFarClassKit instead */
   defineDurableKindMulti: <P, S, B>(
     kindHandle: DurableKindHandle,
     init: (...args: P) => S,
@@ -166,6 +173,7 @@ interface PickFacet {
   ): (...args: Parameters<M>) => ReturnType<M>[F];
 }
 
+/** @deprecated Use vivifyFarClass instead */
 type VivifyKind = <P, S, F>(
   baggage: Baggage,
   tag: string,
@@ -174,6 +182,7 @@ type VivifyKind = <P, S, F>(
   options?: DefineKindOptions<KindContext<S, F>>,
 ) => (...args: P) => KindFacet<F>;
 
+/** @deprecated Use vivifyFarClassKit instead */
 type VivifyKindMulti = <P, S, B>(
   baggage: Baggage,
   tag: string,