@osdk/react-components 0.28.0 → 0.29.0-main-e5533908222aa2ef650553f0a110d4d61ccebac3

package/docs/Prerequisites.md

@@ -4,31 +4,28 @@ sidebar_position: 1
 
 # Prerequisites
 
-Setup required before using `@osdk/react-components` or `@osdk/cbac-components`.
+Setup required before using `@osdk/react-components`.
 
 ## Install dependencies
 
 > **Tip:** If your tooling already installs dependencies, skip this step.
 
-Use whichever package manager your project uses (`# if using CBAC components` lines are optional):
+Use whichever package manager your project uses:
 
 ```bash
 # npm
-npm install @osdk/api@beta @osdk/client@beta @osdk/react@beta
+npm install @osdk/api @osdk/client @osdk/react
 npm install @osdk/react-components
-npm install @osdk/cbac-components # if using CBAC components
 npm install react react-dom classnames
 
 # pnpm
-pnpm add @osdk/api@beta @osdk/client@beta @osdk/react@beta
+pnpm add @osdk/api @osdk/client @osdk/react
 pnpm add @osdk/react-components
-pnpm add @osdk/cbac-components # if using CBAC components
 pnpm add react react-dom classnames
 
 # yarn
-yarn add @osdk/api@beta @osdk/client@beta @osdk/react@beta
+yarn add @osdk/api @osdk/client @osdk/react
 yarn add @osdk/react-components
-yarn add @osdk/cbac-components # if using CBAC components
 yarn add react react-dom classnames
 ```
 
@@ -71,35 +68,28 @@ Apply this to your root element. See the [Base UI docs](https://base-ui.com/reac
 
 ### Layers
 
-Components use CSS [`@layer`](https://developer.mozilla.org/en-US/docs/Web/CSS/@layer) for predictable theming. Add these imports to your application's entry CSS file (e.g., `index.css`).
+Import the component styles into a CSS [`@layer`](https://developer.mozilla.org/en-US/docs/Web/CSS/@layer) in your application's entry CSS file (e.g., `index.css`). Using a layer keeps the cascade predictable: later layers always win when styles conflict, regardless of selector specificity, so your own styles and theme overrides take precedence over the defaults.
 
-| Layer             | Purpose                                                    |
-| ----------------- | ---------------------------------------------------------- |
-| `osdk.tokens`     | Design tokens (colors, spacing, typography) — the defaults |
-| `osdk.components` | Component structural styles (layout, borders, sizing)      |
-
-Later layers always win when styles conflict, regardless of selector specificity.
+The examples below import the styles into a layer named `osdk.components`; declare any of your own layers after it to override.
 
 #### Without Tailwind
 
 ```css
 /* index.css */
-@layer osdk.components, cbac.components;
+@layer osdk.components;
 
 @import "@osdk/react-components/styles.css" layer(osdk.components);
-@import "@osdk/cbac-components/styles.css" layer(cbac.components); /* only needed if using CBAC components */
 ```
 
 #### With Tailwind CSS v4
 
 ```css
 /* index.css */
-@layer tailwind, osdk.components, cbac.components;
+@layer tailwind, osdk.components;
 
 @import "tailwindcss" layer(tailwind);
 
 @import "@osdk/react-components/styles.css" layer(osdk.components);
-@import "@osdk/cbac-components/styles.css" layer(cbac.components); /* only needed if using CBAC components */
 ```
 
 #### Custom theme overrides
@@ -110,7 +100,6 @@ Add a custom layer after the OSDK layers to override any token:
 @layer osdk.components, user.brand;
 
 @import "@osdk/react-components/styles.css" layer(osdk.components);
-@import "@osdk/cbac-components/styles.css" layer(cbac.components); /* only needed if using CBAC components */
 @import "./user-brand.css" layer(user.brand);
 ```
 
@@ -119,7 +108,7 @@ Add a custom layer after the OSDK layers to override any token:
 All components resolve their visual properties through CSS custom properties. There are two scopes of tokens you can target when theming:
 
 - **OSDK tokens (`--osdk-*`)** — every visual property used inside OSDK components resolves through a token prefixed with `--osdk-` (e.g. `--osdk-table-header-bg`, `--osdk-form-section-padding`). Override these to theme **OSDK components only**, leaving other Blueprint components in your app untouched.
-- **Blueprint tokens (`--bp-*`)** — the underlying Blueprint design tokens that `--osdk-*` tokens map to. Override these for consistent theming across **both Blueprint and OSDK components**.
+- **Blueprint tokens (`--bp-*`)** — the underlying Blueprint design tokens that most `--osdk-*` tokens map to. Override these for consistent theming across **both Blueprint and OSDK components**. (A few `--osdk-*` tokens hold raw values rather than mapping to a `--bp-*` token — override those `--osdk-*` tokens directly.)
 
 Per-component references list the `--osdk-*` variables each component exposes — see, for example, [ObjectTable › Theming](./ObjectTable.md#theming). The full catalog of variables lives in [CSSVariables.md](./CSSVariables.md).
 

package/docs/StylingOverview.md

@@ -28,9 +28,9 @@ 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.
+Most OSDK tokens (`--osdk-*`) map to Blueprint tokens by default; a few hold
+raw values instead (e.g. opacities and cursors). Override these to theme OSDK
+components **without** affecting other Blueprint components in your app.
 
 ```css
 :root {
@@ -121,10 +121,13 @@ design-system provider), pass `theme` instead of `defaultTheme`:
 | `--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.
+Most `--osdk-*` tokens map to a `--bp-*` token by default (a handful — e.g.
+`--osdk-disabled-opacity`, `--osdk-drag-handle-cursor` — hold raw values
+instead). If your app uses Blueprint components alongside OSDK components and
+you want a consistent look, override the `--bp-*` tokens; for `--osdk-*` tokens
+with no `--bp-*` backing, override the `--osdk-*` token directly. If you only
+want to restyle OSDK components without affecting Blueprint, override the
+`--osdk-*` tokens.
 
 ## Custom Themes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdk/react-components",
-  "version": "0.28.0",
+  "version": "0.29.0-main-e5533908222aa2ef650553f0a110d4d61ccebac3",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -193,9 +193,9 @@
     "xlsx-republish": "0.20.3"
   },
   "peerDependencies": {
-    "@osdk/api": "^2.8.0",
-    "@osdk/client": "^2.8.0",
-    "@osdk/react": "^2.8.0",
+    "@osdk/api": ">=2.32.0-beta.0",
+    "@osdk/client": ">=2.32.0-beta.0",
+    "@osdk/react": ">=2.32.0-beta.0",
     "@types/react": "^17 || ^18 || ^19",
     "classnames": "^2.0.0",
     "react": "^17 || ^18 || ^19",
@@ -213,11 +213,11 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "typescript": "~5.5.4",
-    "@osdk/client": "2.31.0",
-    "@osdk/api": "2.31.0",
+    "@osdk/api": "2.32.0-main-e5533908222aa2ef650553f0a110d4d61ccebac3",
+    "@osdk/client": "2.32.0-main-e5533908222aa2ef650553f0a110d4d61ccebac3",
     "@osdk/monorepo.api-extractor": "~0.7.0",
     "@osdk/monorepo.tsconfig": "~0.7.0",
-    "@osdk/react": "2.31.0"
+    "@osdk/react": "2.32.0-main-e5533908222aa2ef650553f0a110d4d61ccebac3"
   },
   "publishConfig": {
     "access": "public"

package/build/cjs/chunk-D565X4TE.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/util/UserAgent.ts","../../src/util/withOsdkMetrics.ts"],"names":["useRegisterUserAgent","React"],"mappings":";;;;;;;;;;;;AAgBA,IAAM,kBAAA,GAAqB,yBAAyB,QAA2B,CAAA,CAAA;AACxE,SAAS,mBAAmB,aAAA,EAAe;AAChD,EAAA,OAAO,CAAA,EAAG,kBAAkB,CAAA,CAAA,EAAI,aAAa,CAAA,CAAA;AAC/C;;;ACKO,SAAS,eAAA,CAAgB,WAAW,IAAA,EAAM;AAC/C,EAAA,MAAM,UAAU,CAAA,KAAA,KAAS;AACvB,IAAAA,0BAAA,CAAqB,kBAAA,CAAmB,IAAI,CAAC,CAAA;AAC7C,IAAA,uBAAoBC,sBAAA,CAAM,aAAA,CAAc,SAAA,EAAW,KAAK,CAAA;AAAA,EAC1D,CAAA;AACA,EAAA,OAAA,CAAQ,WAAA,GAAc,mBAAmB,IAAI,CAAA,CAAA,CAAA;AAC7C,EAAA,OAAO,OAAA;AACT","file":"chunk-D565X4TE.cjs","sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nconst PACKAGE_USER_AGENT = `osdk-react-components/${process.env.PACKAGE_VERSION}`;\nexport function componentUserAgent(componentName) {\n  return `${PACKAGE_USER_AGENT}/${componentName}`;\n}","/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useRegisterUserAgent } from \"@osdk/react\";\nimport React from \"react\";\nimport { componentUserAgent } from \"./UserAgent.js\";\n\n// `any` is required: FunctionComponent defaults to FunctionComponent<{}> which\n// rejects components with required props. A generic P parameter doesn't help\n// because TS can't infer both P and C simultaneously from a single argument.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function withOsdkMetrics(Component, name) {\n  const Wrapped = props => {\n    useRegisterUserAgent(componentUserAgent(name));\n    return /*#__PURE__*/React.createElement(Component, props);\n  };\n  Wrapped.displayName = `withOsdkMetrics(${name})`;\n  return Wrapped;\n}"]}