@assistant-ui/mcp-docs-server 0.1.31 → 0.1.33

package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list-item.mdx

@@ -1,11 +1,15 @@
 ---
 title: ThreadListItemPrimitive
-description: Individual thread item with title, archive, and delete controls.
+description: Thread list item primitives for rendering selectable conversation rows with titles, archive controls, delete actions, and menus.
 ---
 
-A single thread item within a thread list.
+import { ThreadListItemPrimitiveArchiveProps, ThreadListItemPrimitiveDeleteProps, ThreadListItemPrimitiveRootProps, ThreadListItemPrimitiveTitleProps, ThreadListItemPrimitiveTriggerProps, ThreadListItemPrimitiveUnarchiveProps } from "@/generated/typeDocs";
+import { ThreadListItemPrimitive as ThreadListItemPrimitiveDocs } from "@/generated/primitiveDocs";
 
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
 
+{/* api-manual:start */}
 ## Anatomy
 
 ```tsx
@@ -22,141 +26,113 @@ const ThreadListItem = () => (
   </ThreadListItemPrimitive.Root>
 );
 ```
+{/* api-manual:end */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## API Reference
 
 ### Root
 
-Contains all parts of the thread list item.
+{ThreadListItemPrimitiveDocs.Root?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Root.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<div>` element unless `asChild` is set. It automatically adds `data-active="true"` and `aria-current="true"` attributes when the thread is the currently active thread.
+{ThreadListItemPrimitiveDocs.Root?.description}
 
-<ParametersTable
-  type="ThreadListItemPrimitiveRootProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemPrimitiveDocs.Root?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Root?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Trigger
+<ParametersTable {...ThreadListItemPrimitiveRootProps} />
 
-A button that switches to the thread when clicked.
+{/* api-manual:ThreadListItemPrimitive.Root:start */}
+| Data attribute | Values |
+| --- | --- |
+| `[data-active]` | Present when this is the current thread. |
+{/* api-manual:ThreadListItemPrimitive.Root:end */}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+### Archive
 
-<ParametersTable
-  type="ThreadListItemPrimitiveTriggerProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemPrimitiveDocs.Archive?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Archive.deprecated}
+  </Callout>
+)}
 
-### Title
+{ThreadListItemPrimitiveDocs.Archive?.description}
 
-Displays the title of the thread.
+{ThreadListItemPrimitiveDocs.Archive?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Archive?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-This primitive renders as a React Fragment with no wrapper DOM element. It outputs the thread's title text directly, or the `fallback` content if no title is available.
+<ParametersTable {...ThreadListItemPrimitiveArchiveProps} />
 
-<ParametersTable
-  type="ThreadListItemPrimitiveTitleProps"
-  parameters={[
-    {
-      name: "fallback",
-      type: "ReactNode",
-      description: "Content to display when the thread has no title.",
-    },
-  ]}
-/>
+### Unarchive
 
-### Archive
+{ThreadListItemPrimitiveDocs.Unarchive?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Unarchive.deprecated}
+  </Callout>
+)}
 
-A button to archive the thread. Only shown for non-archived threads.
+{ThreadListItemPrimitiveDocs.Unarchive?.description}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListItemPrimitiveDocs.Unarchive?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Unarchive?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="ThreadListItemPrimitiveArchiveProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+<ParametersTable {...ThreadListItemPrimitiveUnarchiveProps} />
 
-### Unarchive
+### Delete
 
-A button to unarchive the thread. Only shown for archived threads.
+{ThreadListItemPrimitiveDocs.Delete?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Delete.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListItemPrimitiveDocs.Delete?.description}
 
-<ParametersTable
-  type="ThreadListItemPrimitiveUnarchiveProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemPrimitiveDocs.Delete?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Delete?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Delete
+<ParametersTable {...ThreadListItemPrimitiveDeleteProps} />
 
-A button to permanently delete the thread.
+### Trigger
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListItemPrimitiveDocs.Trigger?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Trigger.deprecated}
+  </Callout>
+)}
 
-<ParametersTable
-  type="ThreadListItemPrimitiveDeleteProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListItemPrimitiveDocs.Trigger?.description}
 
-## Examples
+{ThreadListItemPrimitiveDocs.Trigger?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Trigger?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-### Basic Thread List Item
+<ParametersTable {...ThreadListItemPrimitiveTriggerProps} />
 
-```tsx
-const MyThreadListItem = () => {
-  return (
-    <ThreadListItemPrimitive.Root className="thread-item">
-      <ThreadListItemPrimitive.Trigger className="thread-trigger">
-        <ThreadListItemPrimitive.Title />
-      </ThreadListItemPrimitive.Trigger>
-      <div className="thread-actions">
-        <ThreadListItemPrimitive.Archive>
-          Archive
-        </ThreadListItemPrimitive.Archive>
-        <ThreadListItemPrimitive.Delete>
-          Delete
-        </ThreadListItemPrimitive.Delete>
-      </div>
-    </ThreadListItemPrimitive.Root>
-  );
-};
-```
+### Title
 
-### Archived Thread List Item
+{ThreadListItemPrimitiveDocs.Title?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListItemPrimitiveDocs.Title.deprecated}
+  </Callout>
+)}
 
-```tsx
-const ArchivedThreadListItem = () => {
-  return (
-    <ThreadListItemPrimitive.Root className="archived-thread-item">
-      <ThreadListItemPrimitive.Trigger>
-        <ThreadListItemPrimitive.Title />
-      </ThreadListItemPrimitive.Trigger>
-      <ThreadListItemPrimitive.Unarchive>
-        Restore
-      </ThreadListItemPrimitive.Unarchive>
-      <ThreadListItemPrimitive.Delete>
-        Delete Permanently
-      </ThreadListItemPrimitive.Delete>
-    </ThreadListItemPrimitive.Root>
-  );
-};
-```
+{ThreadListItemPrimitiveDocs.Title?.description}
+
+{ThreadListItemPrimitiveDocs.Title?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListItemPrimitiveDocs.Title?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListItemPrimitiveTitleProps} />
+{/* api-reference:end */}

package/.docs/raw/docs/(reference)/api-reference/primitives/thread-list.mdx

@@ -1,11 +1,17 @@
 ---
 title: ThreadListPrimitive
-description: Display and manage multiple conversation threads with create and archive actions.
+description: Thread list primitives for rendering conversation navigation, new thread actions, and custom assistant sidebars.
 ---
 
-Displays a list of conversation threads.
+import { ThreadListPrimitiveItemByIndexProps, ThreadListPrimitiveItemsProps, ThreadListPrimitiveLoadMoreProps, ThreadListPrimitiveNewProps, ThreadListPrimitiveRootProps } from "@/generated/typeDocs";
+import { ThreadListPrimitive as ThreadListPrimitiveDocs } from "@/generated/primitiveDocs";
 
+{/* AUTO-GENERATED PAGE by scripts/generate-api-reference.mts */}
+{/* Do not edit manually. */}
 
+For examples and usage patterns, see [ThreadList](/docs/primitives/thread-list).
+
+{/* api-manual:start */}
 ## Anatomy
 
 ```tsx
@@ -20,122 +26,97 @@ const ThreadList = () => (
   </ThreadListPrimitive.Root>
 );
 ```
+{/* api-manual:end */}
+
+{/* api-reference:start */}
+{/* AUTO-GENERATED by scripts/generate-api-reference.mts */}
+{/* Do not edit this block manually. */}
 
 ## API Reference
 
 ### Root
 
-Contains all parts of the thread list.
+{ThreadListPrimitiveDocs.Root?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListPrimitiveDocs.Root.deprecated}
+  </Callout>
+)}
+
+{ThreadListPrimitiveDocs.Root?.description}
 
-This primitive renders a `<div>` element unless `asChild` is set.
+{ThreadListPrimitiveDocs.Root?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListPrimitiveDocs.Root?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="ThreadListPrimitiveRootProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+<ParametersTable {...ThreadListPrimitiveRootProps} />
 
 ### New
 
-A button to create a new thread.
+{ThreadListPrimitiveDocs.New?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListPrimitiveDocs.New.deprecated}
+  </Callout>
+)}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListPrimitiveDocs.New?.description}
 
-<ParametersTable
-  type="ThreadListPrimitiveNewProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+{ThreadListPrimitiveDocs.New?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListPrimitiveDocs.New?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListPrimitiveNewProps} />
+
+{/* api-manual:ThreadListPrimitive.New:start */}
+| Data attribute | Values |
+| --- | --- |
+| `[data-active]` | Present when the new-thread button represents the current fresh thread. |
+{/* api-manual:ThreadListPrimitive.New:end */}
 
 ### Items
 
-Renders all items in the thread list.
-
-<ParametersTable
-  type="ThreadListPrimitive.Items.Props"
-  parameters={[
-    {
-      name: "archived",
-      type: "boolean",
-      default: "false",
-      description: "Whether to show archived threads instead of active threads.",
-    },
-    {
-      name: "components",
-      type: "ThreadListItemComponents",
-      required: true,
-      description: "The components to render for each thread list item.",
-      children: [
-        {
-          type: "ThreadListItemComponents",
-          parameters: [
-            {
-              name: "ThreadListItem",
-              type: "ComponentType",
-              required: true,
-              description: "The component to render for each thread in the list.",
-            },
-          ],
-        },
-      ],
-    },
-  ]}
-/>
+{ThreadListPrimitiveDocs.Items?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListPrimitiveDocs.Items.deprecated}
+  </Callout>
+)}
+
+{ThreadListPrimitiveDocs.Items?.description}
+
+{ThreadListPrimitiveDocs.Items?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListPrimitiveDocs.Items?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
+
+<ParametersTable {...ThreadListPrimitiveItemsProps} />
 
 ### ItemByIndex
 
-Renders a single thread list item at the specified index.
+{ThreadListPrimitiveDocs.ItemByIndex?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListPrimitiveDocs.ItemByIndex.deprecated}
+  </Callout>
+)}
 
-```tsx
-<ThreadListPrimitive.ItemByIndex
-  index={0}
-  components={{
-    ThreadListItem: MyThreadListItem
-  }}
-/>
-```
+{ThreadListPrimitiveDocs.ItemByIndex?.description}
+
+{ThreadListPrimitiveDocs.ItemByIndex?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListPrimitiveDocs.ItemByIndex?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="ThreadListPrimitive.ItemByIndex.Props"
-  parameters={[
-    {
-      name: "index",
-      type: "number",
-      required: true,
-      description: "The index of the thread list item to render.",
-    },
-    {
-      name: "archived",
-      type: "boolean",
-      default: "false",
-      description: "Whether to render from archived threads instead of active threads.",
-    },
-    {
-      name: "components",
-      type: "ThreadListItemComponents",
-      required: true,
-      description: "The components to render for the thread list item.",
-    },
-  ]}
-/>
+<ParametersTable {...ThreadListPrimitiveItemByIndexProps} />
 
 ### LoadMore
 
-A button that calls `aui.threads().loadMore()` to append the next page. See the [LoadMore primitive reference](/docs/primitives/thread-list#loadmore) for usage and [Threads concepts](/docs/runtimes/concepts/threads#paginating-the-thread-list) for the adapter contract.
+{ThreadListPrimitiveDocs.LoadMore?.deprecated && (
+  <Callout type="warn">
+    <strong>Deprecated.</strong> {ThreadListPrimitiveDocs.LoadMore.deprecated}
+  </Callout>
+)}
+
+{ThreadListPrimitiveDocs.LoadMore?.description}
 
-This primitive renders a `<button>` element unless `asChild` is set.
+{ThreadListPrimitiveDocs.LoadMore?.element && (
+  <p>This primitive renders a <code>{`<${ThreadListPrimitiveDocs.LoadMore?.element}>`}</code> element unless <code>asChild</code> is set.</p>
+)}
 
-<ParametersTable
-  type="ThreadListPrimitiveLoadMoreProps"
-  parameters={[
-    {
-      name: "asChild",
-    },
-  ]}
-/>
+<ParametersTable {...ThreadListPrimitiveLoadMoreProps} />
+{/* api-reference:end */}