@osdk/react-components 0.20.0-main-4e2a115a796e8664c3972548bb02e707baafa912 → 0.20.0

package/docs/GettingStarted.md

@@ -0,0 +1,65 @@
+# Getting Started
+
+## 1. Install
+
+```bash
+npm install @osdk/react-components @osdk/react @osdk/client @osdk/api react react-dom classnames
+```
+
+## 2. Import styles
+
+Add the component styles to your application CSS entry point:
+
+```css
+/* index.css */
+@layer osdk.components;
+
+@import "@osdk/react-components/styles.css" layer(osdk.components);
+```
+
+Add portal isolation to your root element:
+
+```css
+#root {
+  isolation: isolate;
+}
+```
+
+## 3. Set up the provider
+
+Wrap your application with `OsdkProvider`:
+
+```tsx
+import { createClient } from "@osdk/client";
+import { OsdkProvider } from "@osdk/react";
+
+const client = createClient(
+  "https://your-stack.palantirfoundry.com",
+  "ri.ontology.main.ontology.{UUID}",
+  async () => {
+    // return your auth token
+  },
+);
+
+function App() {
+  return (
+    <OsdkProvider client={client}>
+      {/* your app */}
+    </OsdkProvider>
+  );
+}
+```
+
+## 4. Render your first component
+
+```tsx
+import { ObjectTable } from "@osdk/react-components/experimental/object-table";
+import { Employee } from "@your-osdk-package";
+
+function EmployeeDirectory() {
+  return <ObjectTable objectType={Employee} />;
+}
+```
+
+That's it! The `ObjectTable` handles data fetching, pagination, and sorting
+out of the box.

package/docs/ObjectTable.md

@@ -72,11 +72,12 @@ Add selection mode to enable row selection:
 
 ### Core Props
 
-| Prop         | Type     | Required | Default | Description                     |
-| ------------ | -------- | -------- | ------- | ------------------------------- |
-| `objectType` | `Q`      | ✅       | -       | The OSDK object type to display |
-| `className`  | `string` | ❌       | -       | CSS class for custom styling    |
-| `rowHeight`  | `number` | ❌       | `40`    | Height of each row in pixels    |
+| Prop            | Type      | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                         |
+| --------------- | --------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `objectType`    | `Q`       | ✅       | -       | The OSDK object type to display                                                                                                                                                                                                                                                                                                                                                     |
+| `className`     | `string`  | ❌       | -       | CSS class for custom styling                                                                                                                                                                                                                                                                                                                                                        |
+| `rowHeight`     | `number`  | ❌       | `40`    | Height of each row in pixels                                                                                                                                                                                                                                                                                                                                                        |
+| `streamUpdates` | `boolean` | ❌       | `false` | When `true`, subscribes via websocket so the table automatically updates as matching objects are added, updated, or removed in Foundry. Cannot be used together with `pivotTo` or `withProperties` — the server does not support websocket subscriptions for link-traversal or derived-property queries, so those queries still fetch normally but won't receive real-time updates. |
 
 ### Column Management
 

package/docs/Prerequisites.md

@@ -8,8 +8,7 @@ Setup required before using `@osdk/react-components` or `@osdk/cbac-components`.
 
 ## Install dependencies
 
-:::tip If your tooling already installs dependencies, skip this step.
-:::
+> **Tip:** If your tooling already installs dependencies, skip this step.
 
 Use whichever package manager your project uses (`# if using CBAC components` lines are optional):
 

package/docs/StylingOverview.md

@@ -0,0 +1,146 @@
+# Styling Overview
+
+`@osdk/react-components` uses a three-layer token architecture that makes
+theming predictable and composable.
+
+## Token Architecture
+
+```
+Blueprint Core (@blueprintjs/core)
+         |
+   Blueprint Tokens (--bp-*)
+         |
+   OSDK Tokens (--osdk-*)
+         |
+   Component Styles
+```
+
+[Blueprint](https://blueprintjs.com) is a React UI toolkit built by Palantir.
+OSDK components use Blueprint's design tokens as the foundation layer so they
+integrate seamlessly with other Palantir applications and components that
+already use Blueprint.
+
+### Layer 1: Blueprint Tokens
+
+The foundation. Blueprint design tokens (`--bp-*`) define the raw visual
+primitives — colors, typography, spacing, and intent states. These are
+inherited from `@blueprintjs/core`.
+
+### Layer 2: OSDK Tokens
+
+OSDK tokens (`--osdk-*`) map to Blueprint tokens by default. Override these
+to theme OSDK components **without** affecting other Blueprint components in
+your app.
+
+```css
+:root {
+  /* Override just the OSDK table header */
+  --osdk-table-header-bg: #f5f5f5;
+}
+```
+
+### Layer 3: Component Tokens
+
+Per-component CSS variables (e.g. `--osdk-table-*`, `--osdk-form-*`) control
+specific UI elements. Each component documents its available variables.
+
+## CSS Layers
+
+Styles are organized using CSS `@layer` for predictable cascade ordering:
+
+```css
+@layer osdk.components, user.brand;
+
+@import "@osdk/react-components/styles.css" layer(osdk.components);
+@import "./my-brand.css" layer(user.brand);
+```
+
+Later layers always win, regardless of selector specificity. This means your
+brand overrides will always take precedence over OSDK defaults.
+
+## Dark Mode
+
+Wrap your app with `OsdkThemeProvider` to control the color scheme:
+
+```tsx
+import { OsdkThemeProvider } from "@osdk/react-components/experimental/theme";
+
+function App() {
+  return (
+    <OsdkThemeProvider defaultTheme="system">
+      {/* your app */}
+    </OsdkThemeProvider>
+  );
+}
+```
+
+### Theme modes
+
+| Mode       | Behavior                                                    |
+| ---------- | ----------------------------------------------------------- |
+| `"system"` | Follows the OS `prefers-color-scheme` and updates on change |
+| `"light"`  | Forces light theme regardless of OS setting                 |
+| `"dark"`   | Forces dark theme regardless of OS setting                  |
+
+The provider sets `data-bp-color-scheme` on the document element, which
+the CSS token layer uses to flip both `--bp-*` and `--osdk-*` tokens.
+
+### Switching at runtime
+
+Use the `useOsdkTheme` hook from a descendant to switch modes:
+
+```tsx
+import { useOsdkTheme } from "@osdk/react-components/experimental/theme";
+
+function ThemeToggle() {
+  const { resolvedTheme, setTheme } = useOsdkTheme();
+  return (
+    <button
+      onClick={() => setTheme(resolvedTheme === "dark" ? "light" : "dark")}
+    >
+      Toggle theme
+    </button>
+  );
+}
+```
+
+### Controlled mode
+
+If an external store already owns the theme (e.g. Redux, a parent
+design-system provider), pass `theme` instead of `defaultTheme`:
+
+```tsx
+<OsdkThemeProvider theme={externalTheme} onThemeChanged={setExternalTheme}>
+```
+
+## When to Override `--bp-*` vs `--osdk-*`
+
+| Prefix                 | Override when you want to...                          |
+| ---------------------- | ----------------------------------------------------- |
+| `--bp-*`               | Theme both Blueprint and OSDK components consistently |
+| `--osdk-*`             | Theme only OSDK components, leave Blueprint unchanged |
+| `--osdk-<component>-*` | Customize a single component                          |
+
+Every `--osdk-*` token maps to a `--bp-*` token by default. If your app
+uses Blueprint components alongside OSDK components and you want a
+consistent look, override the `--bp-*` tokens. If you only want to restyle
+OSDK components without affecting Blueprint, override the `--osdk-*` tokens.
+
+## Custom Themes
+
+Create a brand layer that overrides the tokens you care about:
+
+```css
+/* user-brand.css */
+:root {
+  /* Global surface overrides */
+  --osdk-surface-border-radius: 8px;
+
+  /* Table-specific overrides */
+  --osdk-table-header-bg: var(--my-brand-surface);
+  --osdk-table-row-bg-hover: var(--my-brand-hover);
+
+  /* Form-specific overrides */
+  --osdk-form-section-padding: 20px;
+}
+```

package/docs/TokenColors.md

@@ -0,0 +1,130 @@
+# Color Tokens
+
+All color values in `@osdk/react-components` are exposed as CSS custom
+properties. Override them to theme components without touching source code.
+
+## Palette Tokens
+
+Raw color primitives mapped from Blueprint. Use these as building blocks for
+semantic tokens.
+
+| Token                         | Maps to                     |
+| ----------------------------- | --------------------------- |
+| `--osdk-palette-white`        | `--bp-palette-white`        |
+| `--osdk-palette-black`        | `--bp-palette-black`        |
+| `--osdk-palette-gray-1`       | `--bp-palette-gray-1`       |
+| `--osdk-palette-gray-2`       | `--bp-palette-gray-2`       |
+| `--osdk-palette-gray-4`       | `--bp-palette-gray-4`       |
+| `--osdk-palette-dark-gray-2`  | `--bp-palette-dark-gray-2`  |
+| `--osdk-palette-dark-gray-3`  | `--bp-palette-dark-gray-3`  |
+| `--osdk-palette-light-gray-1` | `--bp-palette-light-gray-1` |
+| `--osdk-palette-light-gray-3` | `--bp-palette-light-gray-3` |
+| `--osdk-palette-light-gray-4` | `--bp-palette-light-gray-4` |
+| `--osdk-palette-light-gray-5` | `--bp-palette-light-gray-5` |
+
+## Semantic Background Tokens
+
+Higher-level tokens that abstract palette usage into meaningful roles.
+
+| Token                             | Default                            |
+| --------------------------------- | ---------------------------------- |
+| `--osdk-background-primary`       | `var(--osdk-palette-white)`        |
+| `--osdk-background-secondary`     | `var(--osdk-palette-light-gray-5)` |
+| `--osdk-background-tertiary`      | `var(--osdk-palette-light-gray-4)` |
+| `--osdk-background-skeleton-from` | `color-mix(gray-1, 5%)`            |
+| `--osdk-background-skeleton-to`   | `color-mix(gray-1, 40%)`           |
+| `--osdk-background-backdrop`      | `color-mix(black, 50%)`            |
+
+## Intent Tokens
+
+Intent tokens define interactive color states. Each intent has five states:
+`rest`, `hover`, `active`, `disabled`, and `foreground`.
+
+### Default
+
+| Token                              | Maps to                          |
+| ---------------------------------- | -------------------------------- |
+| `--osdk-intent-default-rest`       | `--bp-intent-default-rest`       |
+| `--osdk-intent-default-hover`      | `--bp-intent-default-hover`      |
+| `--osdk-intent-default-active`     | `--bp-intent-default-active`     |
+| `--osdk-intent-default-disabled`   | `--bp-intent-default-disabled`   |
+| `--osdk-intent-default-foreground` | `--bp-intent-default-foreground` |
+
+### Primary
+
+| Token                              | Maps to                          |
+| ---------------------------------- | -------------------------------- |
+| `--osdk-intent-primary-rest`       | `--bp-intent-primary-rest`       |
+| `--osdk-intent-primary-hover`      | `--bp-intent-primary-hover`      |
+| `--osdk-intent-primary-active`     | `--bp-intent-primary-active`     |
+| `--osdk-intent-primary-disabled`   | `--bp-intent-primary-disabled`   |
+| `--osdk-intent-primary-foreground` | `--bp-intent-primary-foreground` |
+
+### Success
+
+| Token                              | Maps to                          |
+| ---------------------------------- | -------------------------------- |
+| `--osdk-intent-success-rest`       | `--bp-intent-success-rest`       |
+| `--osdk-intent-success-hover`      | `--bp-intent-success-hover`      |
+| `--osdk-intent-success-active`     | `--bp-intent-success-active`     |
+| `--osdk-intent-success-disabled`   | `--bp-intent-success-disabled`   |
+| `--osdk-intent-success-foreground` | `--bp-intent-success-foreground` |
+
+### Warning
+
+| Token                              | Maps to                          |
+| ---------------------------------- | -------------------------------- |
+| `--osdk-intent-warning-rest`       | `--bp-intent-warning-rest`       |
+| `--osdk-intent-warning-hover`      | `--bp-intent-warning-hover`      |
+| `--osdk-intent-warning-active`     | `--bp-intent-warning-active`     |
+| `--osdk-intent-warning-disabled`   | `--bp-intent-warning-disabled`   |
+| `--osdk-intent-warning-foreground` | `--bp-intent-warning-foreground` |
+
+### Danger
+
+| Token                             | Maps to                         |
+| --------------------------------- | ------------------------------- |
+| `--osdk-intent-danger-rest`       | `--bp-intent-danger-rest`       |
+| `--osdk-intent-danger-hover`      | `--bp-intent-danger-hover`      |
+| `--osdk-intent-danger-active`     | `--bp-intent-danger-active`     |
+| `--osdk-intent-danger-disabled`   | `--bp-intent-danger-disabled`   |
+| `--osdk-intent-danger-foreground` | `--bp-intent-danger-foreground` |
+
+## Surface Tokens
+
+| Token                                            | Maps to                                        |
+| ------------------------------------------------ | ---------------------------------------------- |
+| `--osdk-surface-background-color-default-rest`   | `--bp-surface-background-color-default-rest`   |
+| `--osdk-surface-background-color-default-hover`  | `--bp-surface-background-color-default-hover`  |
+| `--osdk-surface-background-color-default-active` | `--bp-surface-background-color-default-active` |
+| `--osdk-surface-background-color-danger-rest`    | `--bp-surface-background-color-danger-rest`    |
+| `--osdk-surface-background-color-danger-hover`   | `--bp-surface-background-color-danger-hover`   |
+| `--osdk-surface-background-color-danger-active`  | `--bp-surface-background-color-danger-active`  |
+| `--osdk-surface-border-color-default`            | `--bp-surface-border-color-default`            |
+| `--osdk-surface-border-color-strong`             | `--bp-surface-border-color-strong`             |
+
+## Custom Color Tokens
+
+Derived colors using `color-mix()` for opacity effects.
+
+| Token                              | Definition                            |
+| ---------------------------------- | ------------------------------------- |
+| `--osdk-custom-color-gray-1`       | `color-mix(gray-1, 5%)`               |
+| `--osdk-custom-color-gray-2`       | `color-mix(gray-1, 8%)`               |
+| `--osdk-custom-color-gray-3`       | `color-mix(gray-1, 10%)`              |
+| `--osdk-custom-color-gray-4`       | `color-mix(gray-1, 20%)`              |
+| `--osdk-custom-color-light-gray-1` | `color-mix(light-gray-1, 60%)`        |
+| `--osdk-custom-color-light-gray-2` | `color-mix(light-gray-5, 50%)`        |
+| `--osdk-custom-color-primary-1`    | `color-mix(intent-primary-rest, 50%)` |
+
+## Typography Color Tokens
+
+| Token                                      | Maps to                                  |
+| ------------------------------------------ | ---------------------------------------- |
+| `--osdk-typography-color-default-rest`     | `--bp-typography-color-default-rest`     |
+| `--osdk-typography-color-default-hover`    | `--bp-typography-color-default-hover`    |
+| `--osdk-typography-color-default-active`   | `--bp-typography-color-default-active`   |
+| `--osdk-typography-color-default-disabled` | `--bp-typography-color-default-disabled` |
+| `--osdk-typography-color-muted`            | `--bp-typography-color-muted`            |
+| `--osdk-typography-color-danger-rest`      | `--bp-typography-color-danger-rest`      |
+| `--osdk-typography-color-danger-active`    | `--bp-typography-color-danger-active`    |

package/docs/TokenSpacing.md

@@ -0,0 +1,73 @@
+# Spacing Tokens
+
+Spacing, border, shadow, and z-index tokens used across
+`@osdk/react-components`. These tokens are a subset of the full
+[CSS Variables reference](./CSSVariables.md), which documents every
+custom property including per-component tokens.
+
+## Surface Spacing
+
+| Token                          | Maps to                      |
+| ------------------------------ | ---------------------------- |
+| `--osdk-surface-spacing`       | `--bp-surface-spacing`       |
+| `--osdk-surface-border-radius` | `--bp-surface-border-radius` |
+| `--osdk-surface-border-width`  | `--bp-surface-border-width`  |
+| `--osdk-surface-layer-primary` | `--bp-surface-layer-primary` |
+
+## Borders
+
+| Token                                 | Default                                                                           |
+| ------------------------------------- | --------------------------------------------------------------------------------- |
+| `--osdk-surface-border`               | `var(--osdk-surface-border-width) solid var(--osdk-surface-border-color-default)` |
+| `--osdk-surface-border-color-default` | `--bp-surface-border-color-default`                                               |
+| `--osdk-surface-border-color-strong`  | `--bp-surface-border-color-strong`                                                |
+
+## Shadows
+
+| Token                     | Maps to                 |
+| ------------------------- | ----------------------- |
+| `--osdk-surface-shadow-2` | `--bp-surface-shadow-2` |
+
+## Z-Index
+
+Four z-index layers provide consistent stacking across components.
+
+| Token                      | Maps to                  | Typical use                       |
+| -------------------------- | ------------------------ | --------------------------------- |
+| `--osdk-surface-z-index-1` | `--bp-surface-z-index-1` | Base content                      |
+| `--osdk-surface-z-index-2` | `--bp-surface-z-index-2` | Sticky headers, floating elements |
+| `--osdk-surface-z-index-3` | `--bp-surface-z-index-3` | Overlays, dropdowns               |
+| `--osdk-surface-z-index-4` | `--bp-surface-z-index-4` | Modals, dialogs                   |
+
+## Focus Tokens
+
+| Token                                 | Maps to                                                                   |
+| ------------------------------------- | ------------------------------------------------------------------------- |
+| `--osdk-emphasis-focus-width`         | `--bp-emphasis-focus-width`                                               |
+| `--osdk-emphasis-focus-color`         | `--bp-emphasis-focus-color`                                               |
+| `--osdk-emphasis-focus-offset`        | `--bp-emphasis-focus-offset`                                              |
+| `--osdk-focus-outline`                | `var(--osdk-emphasis-focus-width) solid var(--osdk-emphasis-focus-color)` |
+| `--osdk-focus-visible-outline-offset` | `var(--osdk-emphasis-focus-offset)`                                       |
+
+## Transition Tokens
+
+| Token                                 | Maps to                             |
+| ------------------------------------- | ----------------------------------- |
+| `--osdk-emphasis-transition-duration` | `--bp-emphasis-transition-duration` |
+| `--osdk-emphasis-ease-default`        | `--bp-emphasis-ease-default`        |
+
+## Miscellaneous
+
+| Token                     | Default |
+| ------------------------- | ------- |
+| `--osdk-disabled-opacity` | `0.5`   |
+
+## Override Example
+
+```css
+/* Increase border radius for a softer look */
+:root {
+  --osdk-surface-border-radius: 8px;
+  --osdk-surface-spacing: 12px;
+}
+```

package/docs/TokenTypography.md

@@ -0,0 +1,57 @@
+# Typography Tokens
+
+Typography tokens control font family, size, weight, and line height across
+all `@osdk/react-components`.
+
+## Font Family
+
+| Token                              | Maps to                          |
+| ---------------------------------- | -------------------------------- |
+| `--osdk-typography-family-default` | `--bp-typography-family-default` |
+
+The default font family inherits from Blueprint, which resolves to the
+system font stack.
+
+## Font Sizes
+
+| Token                                 | Maps to                             | Typical use            |
+| ------------------------------------- | ----------------------------------- | ---------------------- |
+| `--osdk-typography-size-body-x-small` | `--bp-typography-size-body-x-small` | Captions, footnotes    |
+| `--osdk-typography-size-body-small`   | `--bp-typography-size-body-small`   | Secondary text, labels |
+| `--osdk-typography-size-body-medium`  | `--bp-typography-size-body-medium`  | Body text (default)    |
+| `--osdk-typography-size-body-large`   | `--bp-typography-size-body-large`   | Headings, emphasis     |
+
+## Font Weights
+
+| Token                              | Maps to                          | Typical use        |
+| ---------------------------------- | -------------------------------- | ------------------ |
+| `--osdk-typography-weight-default` | `--bp-typography-weight-default` | Body text          |
+| `--osdk-typography-weight-bold`    | `--bp-typography-weight-bold`    | Headings, emphasis |
+
+## Line Height
+
+| Token                                   | Maps to                               |
+| --------------------------------------- | ------------------------------------- |
+| `--osdk-typography-line-height-default` | `--bp-typography-line-height-default` |
+
+## Global Defaults
+
+The root element sets these defaults for all OSDK components:
+
+```css
+:root {
+  font-family: var(--osdk-typography-family-default);
+  color: var(--osdk-typography-color-default-rest);
+  font-size: var(--osdk-typography-size-body-medium);
+}
+```
+
+## Override Example
+
+```css
+/* Make all OSDK components use a custom font */
+:root {
+  --osdk-typography-family-default: "Inter", sans-serif;
+  --osdk-typography-size-body-medium: 15px;
+}
+```

package/docs/UsageWithOsdk.md

@@ -0,0 +1,47 @@
+# Usage with OSDK
+
+`@osdk/react-components` is built on top of
+[`@osdk/react`](https://github.com/palantir/osdk-ts/tree/main/packages/react),
+which provides hooks for fetching Ontology data. Components accept OSDK types
+directly and handle data loading, caching, and state management automatically.
+
+## How it works
+
+Every OSDK-aware component follows a two-layer architecture:
+
+1. **OSDK layer** (e.g. `ObjectTable`, `FilterList`, `ActionForm`) — fetches
+   data via `@osdk/react` hooks, converts OSDK entities into primitives, and
+   passes them down.
+2. **Base layer** (e.g. `BaseTable`, `BaseFilterList`) — a pure React
+   component with no OSDK imports. It receives primitives and handles all UI
+   interactions and styling.
+
+This means you can always drop down to the `Base*` variant and bring your own
+data source.
+
+## OsdkProvider
+
+All components require an `OsdkProvider` wrapping your app. The provider
+supplies the OSDK client that hooks use for network requests.
+
+```tsx
+import { createClient } from "@osdk/client";
+import { OsdkProvider } from "@osdk/react";
+
+const client = createClient(
+  "https://your-stack.palantirfoundry.com",
+  "your-ontology-rid",
+  async () => "your-auth-token",
+);
+
+function App() {
+  return (
+    <OsdkProvider client={client}>
+      {/* All @osdk/react-components go inside here */}
+    </OsdkProvider>
+  );
+}
+```
+
+Refer to individual component stories for up-to-date usage examples — the
+component API is under active development and props may change between releases.

package/docs/Welcome.md

@@ -0,0 +1,42 @@
+# OSDK React Components
+
+React components for building Foundry applications. These components are
+Ontology-aware — pass in OSDK entities, and they handle data loading, caching,
+and state management automatically.
+
+Built on top of [`@osdk/react`](https://github.com/palantir/osdk-ts/tree/main/packages/react),
+these components use OSDK hooks internally to provide ready-to-use UI elements.
+While `@osdk/react` gives you low-level hooks for data fetching,
+`@osdk/react-components` provides UI widgets for common patterns like tables,
+forms, and filters.
+
+## Available Components
+
+| Component        | Description                                                                  |
+| ---------------- | ---------------------------------------------------------------------------- |
+| `ObjectTable`    | Displays an Object Set as a sortable, paginated table with inline editing    |
+| `FilterList`     | Interactive filter panel with histogram filters, date ranges, and search     |
+| `ActionForm`     | Auto-generated form for executing Ontology Actions                           |
+| `DocumentViewer` | Unified media viewer that auto-detects file type (PDF, Excel, images, video) |
+| `AipAgentChat`   | Chat surface backed by Foundry LMS                                           |
+
+All components are exported under `@osdk/react-components/experimental/*`
+sub-paths (e.g. `@osdk/react-components/experimental/object-table`).
+
+## Quick Start
+
+```bash
+npm install @osdk/react-components @osdk/react @osdk/client @osdk/api react react-dom classnames
+```
+
+```tsx
+import { ObjectTable } from "@osdk/react-components/experimental/object-table";
+import { Employee } from "@your-osdk-package";
+
+function EmployeeDirectory() {
+  return <ObjectTable objectType={Employee} />;
+}
+```
+
+See the **Installation** page for full setup instructions including CSS layers
+and provider configuration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react-components",
-  "version": "0.20.0-main-4e2a115a796e8664c3972548bb02e707baafa912",
+  "version": "0.20.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -193,9 +193,9 @@
     "xlsx": "^0.18.5"
   },
   "peerDependencies": {
-    "@osdk/api": ">=2.24.0-beta.0",
-    "@osdk/client": ">=2.24.0-beta.0",
-    "@osdk/react": ">=2.24.0-beta.0",
+    "@osdk/api": "^2.8.0",
+    "@osdk/client": "^2.8.0",
+    "@osdk/react": "^2.8.0",
     "@types/react": "^17 || ^18 || ^19",
     "classnames": "^2.0.0",
     "react": "^17 || ^18 || ^19",
@@ -219,12 +219,12 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "~5.5.4",
+    "@osdk/api": "2.24.0",
     "@osdk/aip-core": "0.4.0",
-    "@osdk/api": "2.24.0-main-4e2a115a796e8664c3972548bb02e707baafa912",
-    "@osdk/client": "2.24.0-main-4e2a115a796e8664c3972548bb02e707baafa912",
-    "@osdk/monorepo.api-extractor": "~0.7.0",
+    "@osdk/client": "2.24.0",
     "@osdk/monorepo.tsconfig": "~0.7.0",
-    "@osdk/react": "2.24.0-main-4e2a115a796e8664c3972548bb02e707baafa912"
+    "@osdk/react": "2.24.0",
+    "@osdk/monorepo.api-extractor": "~0.7.0"
   },
   "publishConfig": {
     "access": "public"