Add thread types

Author: KrisBraun

.changeset/thread-type.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Added: `ThreadType` type and `type` field on `Thread`, `NewThread`, and `ThreadUpdate` for setting thread sub-type/category

twister/src/plot.ts

@@ -336,6 +336,21 @@ export type ThreadMeta = {
   [key: string]: JSONValue;
 };
 
+/**
+ * Thread sub-type that determines the thread's icon and category.
+ * Available types depend on whether the priority is shared:
+ * - Private priorities: "notes" (default), "idea", "goal", "decision"
+ * - Shared priorities: all above plus "discussion" (default), "announcement", "ask"
+ */
+export type ThreadType =
+  | "notes"
+  | "idea"
+  | "goal"
+  | "decision"
+  | "discussion"
+  | "announcement"
+  | "ask";
+
 /**
  * Tags on an item, along with the actors who added each tag.
  */
@@ -379,6 +394,8 @@ type ThreadFields = ThreadCommon & {
   title: string;
   /** The priority context this thread belongs to */
   priority: Priority;
+  /** The thread's sub-type/category. Determines the displayed icon. */
+  type: ThreadType | null;
   /** The schedule associated with this thread, if any */
   schedule?: Schedule;
   /** Source-specific metadata from the thread's link, populated on callbacks */
@@ -467,6 +484,12 @@ export type NewThread = Partial<
      */
     tags?: NewTags;
 
+    /**
+     * The thread's sub-type/category. Sets the thread's icon.
+     * If omitted, defaults to "notes" (private) or "discussion" (shared).
+     */
+    type?: ThreadType;
+
     /**
      * Whether the thread should be marked as unread for users.
      * - undefined/omitted (default): Thread is unread for users, except auto-marked
@@ -533,6 +556,11 @@ type ThreadSingleUpdateFields = ThreadBulkUpdateFields & {
    */
   twistTags?: Partial<Record<Tag, boolean>>;
 
+  /**
+   * Update the thread's sub-type/category.
+   */
+  type?: ThreadType;
+
   /**
    * Optional preview content for the thread. Can be Markdown formatted.
    * The preview will be automatically generated from this content (truncated to 100 chars).