@c15t/react 2.0.0-rc.8 → 2.0.0

package/docs/iab/use-gvl-data.md

@@ -1,208 +1,20 @@
 ---
-title: useGVLData
-description: Hook to access processed Global Vendor List (GVL) data for building custom IAB TCF UI components.
+title: useGVLData (Internal)
+description: Status note for the internal GVL hook used by the built-in IAB dialog.
 ---
 > ❌ **Error:**
 > c15t is not yet IAB certified. The IAB TCF components are under active development and should not be used in production. APIs and behavior may change before certification is achieved.
 
-`useGVLData()` processes the raw IAB Global Vendor List (GVL) into a UI-friendly format. It handles purpose grouping into stacks, vendor mapping, special purpose/feature extraction, and loading state.
+`useGVLData()` currently powers the built-in `IABConsentDialog`, but it is **not part of the public package surface**.
 
-Use this hook when building a custom IAB TCF UI instead of the pre-built `IABConsentDialog`.
+Older docs showed it as a public hook. That is no longer accurate.
 
-```tsx
-import { useGVLData } from '@c15t/react/hooks';
+If you need supported customization points today:
 
-function CustomIABPreferences() {
-  const { purposes, stacks, standalonePurposes, totalVendors, isLoading } = useGVLData();
-
-  if (isLoading) return <p>Loading vendor data...</p>;
-
-  return (
-    <div>
-      <p>{totalVendors} partners</p>
-      {standalonePurposes.map((purpose) => (
-        <div key={purpose.id}>
-          <h3>{purpose.name}</h3>
-          <p>{purpose.description}</p>
-          <p>{purpose.vendors.length} vendors</p>
-        </div>
-      ))}
-    </div>
-  );
-}
-```
+* Use `IABConsentBanner` and `IABConsentDialog` from `@c15t/react/iab` for the supported prebuilt UI
+* Use `useHeadlessIABConsentUI()` from `@c15t/react/iab` when you need lower-level control over banner/dialog state and actions
 
 > ℹ️ **Info:**
-> Must be used within a ConsentManagerProvider with IAB mode enabled. Returns empty data if IAB is not configured.
-
-## Return Value
-
-The hook returns a `GVLData` object:
-
-### GVLData
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-|specialPurposes|ProcessedPurpose|-|-|✅ Required|
-|specialFeatures|ProcessedSpecialFeature|-|-|✅ Required|
-|features|ProcessedFeature|-|-|✅ Required|
-|stacks|ProcessedStack|-|-|✅ Required|
-|standalonePurposes|ProcessedPurpose|-|-|✅ Required|
-|totalVendors|number|-|-|✅ Required|
-|isLoading|boolean|-|-|✅ Required|
-
-#### `purposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `specialPurposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `specialFeatures` ProcessedSpecialFeature
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-
-#### `features` ProcessedFeature
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-
-#### `stacks` ProcessedStack
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-
-#### `standalonePurposes` ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-## Types
-
-### ProcessedPurpose
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
-|isSpecialPurpose|boolean \|undefined|-|-|Optional|
-
-#### `vendors` ProcessedVendor
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|VendorId|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|policyUrl|string|-|-|✅ Required|
-|usesNonCookieAccess|boolean|-|-|✅ Required|
-|deviceStorageDisclosureUrl|string \|null|-|-|✅ Required|
-|usesCookies|boolean|-|-|✅ Required|
-|cookieMaxAgeSeconds|number \|null|-|-|✅ Required|
-|cookieRefresh|boolean \|undefined|-|-|Optional|
-|specialPurposes|number\[]|-|-|✅ Required|
-|specialFeatures|number\[]|-|-|✅ Required|
-|features|number\[]|-|-|✅ Required|
-|purposes|number\[]|-|-|✅ Required|
-|legIntPurposes|number\[]|-|-|✅ Required|
-|legitimateInterestUrl|string \|null \|undefined|-|-|Optional|
-|isCustom|boolean \|undefined|-|-|Optional|
-|usesLegitimateInterest|boolean \|undefined|-|-|Optional|
-|dataRetention|Object \|undefined|-|-|Optional|
-|dataDeclaration|number\[] \|undefined|-|-|Optional|
-
-### ProcessedVendor
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|VendorId|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|policyUrl|string|-|-|✅ Required|
-|usesNonCookieAccess|boolean|-|-|✅ Required|
-|deviceStorageDisclosureUrl|string \|null|-|-|✅ Required|
-|usesCookies|boolean|-|-|✅ Required|
-|cookieMaxAgeSeconds|number \|null|-|-|✅ Required|
-|cookieRefresh|boolean \|undefined|-|-|Optional|
-|specialPurposes|number\[]|-|-|✅ Required|
-|specialFeatures|number\[]|-|-|✅ Required|
-|features|number\[]|-|-|✅ Required|
-|purposes|number\[]|-|-|✅ Required|
-|legIntPurposes|number\[]|-|-|✅ Required|
-|legitimateInterestUrl|string \|null \|undefined|-|-|Optional|
-|isCustom|boolean \|undefined|-|-|Optional|
-|usesLegitimateInterest|boolean \|undefined|-|-|Optional|
-|dataRetention|Object \|undefined|-|-|Optional|
-|dataDeclaration|number\[] \|undefined|-|-|Optional|
-
-#### `dataRetention`
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|purposes|Record\<number, number> \|undefined|-|-|Optional|
-|specialPurposes|Record\<number, number> \|undefined|-|-|Optional|
-|stdRetention|number \|undefined|-|-|Optional|
-
-### ProcessedStack
-
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|purposes|ProcessedPurpose|-|-|✅ Required|
-
-### ProcessedSpecialFeature
+> Until useGVLData() is exported as public API, avoid importing it from deep internal paths. Those paths are not covered by semver guarantees and can change without notice.
 
-|Property|Type|Description|Default|Required|
-|:--|:--|:--|:--|:--:|
-|id|number|-|-|✅ Required|
-|name|string|-|-|✅ Required|
-|description|string|-|-|✅ Required|
-|descriptionLegal|string \|undefined|-|-|Optional|
-|illustrations|string\[]|-|-|✅ Required|
-|vendors|ProcessedVendor|-|-|✅ Required|
+When a public GVL-focused hook becomes part of the supported API, this page should document that public surface instead of the internal dialog hook.

package/docs/internationalization.md

@@ -10,7 +10,7 @@ There are two ways c15t can load translations: client-side or server-side.
 
 |Server-side|Client-side|
 |--|--|
-|The best way to reduce bundle size and improve performance. We can detect the user's language based on the browser's language settings, allowing for the most accurate translations. By default, when using a [consent.io](https://consent.io) hosted instance, [these languages](https://github.com/c15t/c15t/tree/main/packages/translations/src/translations) are supported.|Bundled with the application allowing for multiple languages to be supported without the need for a backend. The more translations you have, the larger the bundle size will be, which may impact the performance of your application.|
+|The best way to reduce bundle size and improve performance. We can detect the user's language based on the browser's language settings, allowing for the most accurate translations. By default, when using a [inth.com](https://inth.com) hosted instance, [these languages](https://github.com/c15t/c15t/tree/main/packages/translations/src/translations) are supported.|Bundled with the application allowing for multiple languages to be supported without the need for a backend. The more translations you have, the larger the bundle size will be, which may impact the performance of your application.|
 
 ## Basic Configuration
 

package/docs/optimization.md

@@ -1,10 +1,25 @@
 ---
 title: Optimization
 description: Improve c15t startup performance in React with prefetching, proxy rewrites, and rendering tradeoffs.
-lastModified: 2026-03-17
+lastModified: 2026-04-14
 ---
 Use this guide when you care about banner visibility speed, route static-ness, and reducing backend round-trip cost.
 
+## Start Here
+
+Apply the optimizations in this order:
+
+|Situation|Use|Why|Tradeoff|
+|--|--|--|--|
+|Any production app using hosted mode|Same-origin `/api/c15t` proxy|Lowers browser startup overhead and keeps the backend origin out of client config|Requires framework or platform proxy setup|
+|Banner speed matters on cold loads|`buildPrefetchScript()`|Starts `/init` before your app hydrates|Still a browser-side fetch, not SSR|
+|Your app navigates client-side|Keep the provider mounted at the app root|Avoids remounting and re-running init work|Requires provider placement discipline|
+|You cannot proxy and must stay cross-origin|`<link rel="preconnect">`|Starts DNS/TLS work earlier|Smaller gain than same-origin proxying|
+|You are using Next.js and want SSR or static-route-specific guidance|Next.js optimization docs|Covers `C15tPrefetch`, `fetchInitialData()`, and rendering tradeoffs|Next-specific|
+
+> ℹ️ **Info:**
+> Treat same-origin proxying as the baseline optimization. The others are situational layers you add when startup timing or route behavior justifies them.
+
 ## 1) Prefer Same-Origin Proxy
 
 Proxy c15t requests through your app server so the browser calls your own origin instead of a third-party domain.
@@ -23,6 +38,8 @@ Why this helps:
 * Ad blockers are less likely to block your init endpoint
 * You can change backend infrastructure without touching client code
 
+If you can only do one optimization, do this one first.
+
 ## 2) Prefetch Init Data Early
 
 Use `buildPrefetchScript()` from the `c15t` core package to start the `/init` request before your app hydrates. Inject the script as early as possible in your HTML `<head>`.
@@ -35,6 +52,12 @@ In production benchmarks with a same-origin rewrite, prefetching strategies show
 |Browser prefetch|\~1.3x faster|\~2.6x earlier|\~1.25x faster|
 |Server prefetch|\~2x faster|before page loads|\~1.9x faster|
 
+Use this when:
+
+* The app is client-rendered
+* You want a faster first banner without introducing SSR complexity
+* You control the HTML template or document `<head>`
+
 ### Inline Script Prefetch
 
 ```tsx
@@ -88,6 +111,8 @@ Why this helps:
 * Prevents extra callback churn from remount cycles
 * Keeps banner/dialog state stable between route transitions
 
+Mount `ConsentManagerProvider` as high in the tree as possible so route transitions do not recreate it.
+
 ## Animation Performance
 
 The default motion tokens are tuned for speed-first product UI:
@@ -104,6 +129,8 @@ To customize motion durations and easing, see [Styling](/docs/frameworks/react/s
 
 ## Reduce Network Overhead
 
+If your browser must call a cross-origin backend URL directly, add `preconnect` so the browser can warm up the connection earlier. This is a fallback optimization when same-origin proxying is not possible.
+
 If you must use a cross-origin backend URL, add preconnect so the browser starts DNS/TLS early:
 
 ```tsx
@@ -111,3 +138,10 @@ If you must use a cross-origin backend URL, add preconnect so the browser starts
   <link rel="preconnect" href="https://your-instance.c15t.dev" crossOrigin="" />
 </head>
 ```
+
+## Next.js-Specific SSR And Static Routes
+
+This page is intentionally React-generic. If you are using Next.js and need SSR or static-route-specific guidance:
+
+* See [Next.js Optimization](/docs/frameworks/next/optimization) for the static-vs-dynamic decision guide
+* See [Next.js Server-Side Data Fetching](/docs/frameworks/next/server-side) for `fetchInitialData()`

package/docs/policy-packs.md

@@ -13,7 +13,7 @@ When a backend isn't available — local development, static previews, Storybook
 
 ## Hosted Mode (Recommended)
 
-When using consent.io or a self-hosted backend, the provider connects automatically. No policy configuration is needed on the frontend:
+When using inth.com or a self-hosted backend, the provider connects automatically. No policy configuration is needed on the frontend:
 
 ```tsx
 <ConsentManagerProvider

package/docs/quickstart.md

@@ -17,10 +17,10 @@ availableIn:
 
 |Package manager|Command|
 |:--|:--|
-|npm|`npx @c15t/cli@rc`|
-|pnpm|`pnpm dlx @c15t/cli@rc`|
-|yarn|`yarn dlx @c15t/cli@rc`|
-|bun|`bunx @c15t/cli@rc`|
+|npm|`npx @c15t/cli`|
+|pnpm|`pnpm dlx @c15t/cli`|
+|yarn|`yarn dlx @c15t/cli`|
+|bun|`bunx @c15t/cli`|
 
 ## Manual Installation
 
@@ -107,6 +107,9 @@ availableIn:
 
    A consent banner appears at the bottom of the pageClicking "Customize" opens a dialog with toggles for each consent categoryAfter accepting or rejecting, the banner dismisses and your choice persists across page reloads
 
+> ℹ️ **Info:**
+> Want to improve startup performance? See Optimization for the decision guide, prefetch setup, and network tuning.
+
 ## Optional: Add DevTools
 
 Install DevTools only if you want a runtime inspector while building and debugging:
@@ -142,10 +145,10 @@ Install c15t agent skills to let AI agents help with styling, i18n, scripts & ot
 
 |Package manager|Command|
 |:--|:--|
-|npm|`npx @c15t/cli@rc skills`|
-|pnpm|`pnpm dlx @c15t/cli@rc skills`|
-|yarn|`yarn dlx @c15t/cli@rc skills`|
-|bun|`bunx @c15t/cli@rc skills`|
+|npm|`npx @c15t/cli skills`|
+|pnpm|`pnpm dlx @c15t/cli skills`|
+|yarn|`yarn dlx @c15t/cli skills`|
+|bun|`bunx @c15t/cli skills`|
 
 See [AI Agents](/docs/ai-agents) for bundled package docs and agent skills.
 

package/docs/styling/color-scheme.md

@@ -65,7 +65,7 @@ function ThemeToggle() {
 
 ## How Dark Mode Works
 
-When dark mode is active, c15t applies the `dark` token values as CSS variable overrides. Only tokens specified in `dark` are overridden - unset tokens fall back to the `colors` values.
+When dark mode is active, c15t applies the `dark` token values as CSS variable overrides. Only tokens specified in `dark` are overridden - unset tokens fall back to the `colors` values. This also applies to `textOnPrimary`: if you omit it, c15t derives a readable foreground from the active `primary` color in that scheme.
 
 ```tsx
 const theme = {

package/docs/styling/css-variables.md

@@ -18,7 +18,7 @@ Every theme token is converted to a `--c15t-*` CSS custom property at runtime. Y
 |--c15t-border-hover|string \|undefined|\`colors.borderHover\` (default: \`hsl(0, 0%, 85%)\`)|-|Optional|
 |--c15t-text|string \|undefined|\`colors.text\` (default: \`hsl(0, 0%, 10%)\`)|-|Optional|
 |--c15t-text-muted|string \|undefined|\`colors.textMuted\` (default: \`hsl(0, 0%, 40%)\`)|-|Optional|
-|--c15t-text-on-primary|string \|undefined|\`colors.textOnPrimary\` (default: \`hsl(0, 0%, 100%)\`)|-|Optional|
+|--c15t-text-on-primary|string \|undefined|\`colors.textOnPrimary\` (auto-derived from \`colors.primary\` when omitted)|-|Optional|
 |--c15t-overlay|string \|undefined|\`colors.overlay\` (default: \`hsla(0, 0%, 0%, 0.5)\`)|-|Optional|
 |--c15t-switch-track|string \|undefined|\`colors.switchTrack\` (default: \`hsl(0, 0%, 85%)\`)|-|Optional|
 |--c15t-switch-track-active|string \|undefined|\`colors.switchTrackActive\` (default: \`hsl(228, 100%, 60%)\`)|-|Optional|

package/docs/styling/overview.md

@@ -102,6 +102,7 @@ Use tokens first when the change is semantic:
 * Banner card background -> `theme.colors.surface`
 * Banner footer background -> `theme.colors.surfaceHover`
 * Shared copy color -> `theme.colors.text` and `theme.colors.textMuted`
+* Primary-filled surfaces such as stock branding tags and filled actions -> `theme.colors.primary` with `theme.colors.textOnPrimary` as the matching foreground override
 
 ```tsx
 options={{
@@ -114,6 +115,8 @@ options={{
 }}
 ```
 
+If you set `theme.colors.primary` but omit `theme.colors.textOnPrimary`, c15t derives a readable foreground automatically. Add `textOnPrimary` only when you need to force a specific branded foreground color.
+
 ### 3. Component slots
 
 Target specific component parts via the `slots` object:
@@ -317,7 +320,7 @@ Color palette for light mode.
 |borderHover|string \|undefined|Hover state for bordered elements.|-|Optional|
 |text|string \|undefined|Primary text color for headings and body.|-|Optional|
 |textMuted|string \|undefined|Muted text color for secondary content.|-|Optional|
-|textOnPrimary|string \|undefined|Text color for content on primary background.|-|Optional|
+|textOnPrimary|string \|undefined|Text color for content on primary background. Auto-derived from \`primary\` when omitted.|-|Optional|
 |overlay|string \|undefined|Overlay color for modal backdrops.|-|Optional|
 |switchTrack|string \|undefined|Toggle track color (off state).|-|Optional|
 |switchTrackActive|string \|undefined|Toggle track color (on state).|-|Optional|
@@ -337,7 +340,7 @@ Dark mode color overrides.
 |borderHover|string \|undefined|Hover state for bordered elements.|-|Optional|
 |text|string \|undefined|Primary text color for headings and body.|-|Optional|
 |textMuted|string \|undefined|Muted text color for secondary content.|-|Optional|
-|textOnPrimary|string \|undefined|Text color for content on primary background.|-|Optional|
+|textOnPrimary|string \|undefined|Text color for content on primary background. Auto-derived from \`primary\` when omitted.|-|Optional|
 |overlay|string \|undefined|Overlay color for modal backdrops.|-|Optional|
 |switchTrack|string \|undefined|Toggle track color (off state).|-|Optional|
 |switchTrackActive|string \|undefined|Toggle track color (on state).|-|Optional|
@@ -423,6 +426,7 @@ Component-specific style overrides.
 |consentBannerDescription|SlotStyle \|undefined|Banner description text element.|-|Optional|
 |consentBannerFooter|SlotStyle \|undefined|Footer container for banner action buttons.|-|Optional|
 |consentBannerFooterSubGroup|SlotStyle \|undefined|Nested button group inside the banner footer.|-|Optional|
+|consentBannerTag|SlotStyle \|undefined|Branding tag rendered above the consent banner card.|-|Optional|
 |consentBannerOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the banner when enabled.|-|Optional|
 |consentDialog|SlotStyle \|undefined|Root wrapper for the consent dialog modal.|-|Optional|
 |consentDialogCard|SlotStyle \|undefined|Main dialog card container.|-|Optional|
@@ -430,22 +434,25 @@ Component-specific style overrides.
 |consentDialogTitle|SlotStyle \|undefined|Dialog title text element.|-|Optional|
 |consentDialogDescription|SlotStyle \|undefined|Dialog description text element.|-|Optional|
 |consentDialogContent|SlotStyle \|undefined|Dialog content region (typically holds ConsentWidget).|-|Optional|
-|consentDialogFooter|SlotStyle \|undefined|Dialog footer container with actions/branding.|-|Optional|
+|consentDialogFooter|SlotStyle \|undefined|Footer container used by compound dialog layouts.|-|Optional|
+|consentDialogTag|SlotStyle \|undefined|Branding tag rendered below the stock consent dialog card.|-|Optional|
 |consentDialogOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the dialog.|-|Optional|
 |consentWidget|SlotStyle \|undefined|Root wrapper for the consent widget/preferences panel.|-|Optional|
 |consentWidgetAccordion|SlotStyle \|undefined|Accordion region listing consent categories.|-|Optional|
 |consentWidgetFooter|SlotStyle \|undefined|Footer area for widget actions and links.|-|Optional|
-|consentWidgetBranding|SlotStyle \|undefined|Branding element rendered in the widget footer.|-|Optional|
+|consentWidgetTag|SlotStyle \|undefined|Branding tag rendered below the standalone consent widget.|-|Optional|
 |frame|SlotStyle \|undefined|Frame wrapper used by blocking placeholders (e.g., iframe blocking).|-|Optional|
 |iabConsentBanner|SlotStyle \|undefined|Root wrapper for the IAB consent banner.|-|Optional|
 |iabConsentBannerCard|SlotStyle \|undefined|Main card container for IAB banner content.|-|Optional|
 |iabConsentBannerHeader|SlotStyle \|undefined|Header region for IAB banner title/description.|-|Optional|
 |iabConsentBannerFooter|SlotStyle \|undefined|Footer container for IAB banner actions.|-|Optional|
+|iabConsentBannerTag|SlotStyle \|undefined|Branding tag rendered above the IAB banner card.|-|Optional|
 |iabConsentBannerOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the IAB banner.|-|Optional|
 |iabConsentDialog|SlotStyle \|undefined|Root wrapper for the IAB consent dialog.|-|Optional|
 |iabConsentDialogCard|SlotStyle \|undefined|Main card container for IAB dialog content.|-|Optional|
 |iabConsentDialogHeader|SlotStyle \|undefined|Header region for IAB dialog title/description.|-|Optional|
 |iabConsentDialogFooter|SlotStyle \|undefined|Footer container for IAB dialog actions.|-|Optional|
+|iabConsentDialogTag|SlotStyle \|undefined|Branding tag rendered below the IAB dialog card.|-|Optional|
 |iabConsentDialogOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the IAB dialog.|-|Optional|
 |buttonPrimary|SlotStyle \|undefined|Shared primary button style used across consent components.|-|Optional|
 |buttonSecondary|SlotStyle \|undefined|Shared secondary button style used across consent components.|-|Optional|

package/docs/styling/slots.md

@@ -4,7 +4,7 @@ description: Target individual component parts with styles using the slot system
 ---
 ## What are Slots?
 
-Slots let you target specific parts of consent components with styles. Each component is built from named slots such as `consentBannerTitle` and `consentDialogFooter`.
+Slots let you target specific parts of consent components with styles. Each component is built from named slots such as `consentBannerTitle` and `consentDialogTag`.
 
 Use slots after the stock component APIs and design tokens:
 
@@ -88,6 +88,7 @@ Use the typed API reference below for the full slot list and descriptions. It st
 |consentBannerDescription|SlotStyle \|undefined|Banner description text element.|-|Optional|
 |consentBannerFooter|SlotStyle \|undefined|Footer container for banner action buttons.|-|Optional|
 |consentBannerFooterSubGroup|SlotStyle \|undefined|Nested button group inside the banner footer.|-|Optional|
+|consentBannerTag|SlotStyle \|undefined|Branding tag rendered above the consent banner card.|-|Optional|
 |consentBannerOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the banner when enabled.|-|Optional|
 |consentDialog|SlotStyle \|undefined|Root wrapper for the consent dialog modal.|-|Optional|
 |consentDialogCard|SlotStyle \|undefined|Main dialog card container.|-|Optional|
@@ -95,22 +96,25 @@ Use the typed API reference below for the full slot list and descriptions. It st
 |consentDialogTitle|SlotStyle \|undefined|Dialog title text element.|-|Optional|
 |consentDialogDescription|SlotStyle \|undefined|Dialog description text element.|-|Optional|
 |consentDialogContent|SlotStyle \|undefined|Dialog content region (typically holds ConsentWidget).|-|Optional|
-|consentDialogFooter|SlotStyle \|undefined|Dialog footer container with actions/branding.|-|Optional|
+|consentDialogFooter|SlotStyle \|undefined|Footer container used by compound dialog layouts.|-|Optional|
+|consentDialogTag|SlotStyle \|undefined|Branding tag rendered below the stock consent dialog card.|-|Optional|
 |consentDialogOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the dialog.|-|Optional|
 |consentWidget|SlotStyle \|undefined|Root wrapper for the consent widget/preferences panel.|-|Optional|
 |consentWidgetAccordion|SlotStyle \|undefined|Accordion region listing consent categories.|-|Optional|
 |consentWidgetFooter|SlotStyle \|undefined|Footer area for widget actions and links.|-|Optional|
-|consentWidgetBranding|SlotStyle \|undefined|Branding element rendered in the widget footer.|-|Optional|
+|consentWidgetTag|SlotStyle \|undefined|Branding tag rendered below the standalone consent widget.|-|Optional|
 |frame|SlotStyle \|undefined|Frame wrapper used by blocking placeholders (e.g., iframe blocking).|-|Optional|
 |iabConsentBanner|SlotStyle \|undefined|Root wrapper for the IAB consent banner.|-|Optional|
 |iabConsentBannerCard|SlotStyle \|undefined|Main card container for IAB banner content.|-|Optional|
 |iabConsentBannerHeader|SlotStyle \|undefined|Header region for IAB banner title/description.|-|Optional|
 |iabConsentBannerFooter|SlotStyle \|undefined|Footer container for IAB banner actions.|-|Optional|
+|iabConsentBannerTag|SlotStyle \|undefined|Branding tag rendered above the IAB banner card.|-|Optional|
 |iabConsentBannerOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the IAB banner.|-|Optional|
 |iabConsentDialog|SlotStyle \|undefined|Root wrapper for the IAB consent dialog.|-|Optional|
 |iabConsentDialogCard|SlotStyle \|undefined|Main card container for IAB dialog content.|-|Optional|
 |iabConsentDialogHeader|SlotStyle \|undefined|Header region for IAB dialog title/description.|-|Optional|
 |iabConsentDialogFooter|SlotStyle \|undefined|Footer container for IAB dialog actions.|-|Optional|
+|iabConsentDialogTag|SlotStyle \|undefined|Branding tag rendered below the IAB dialog card.|-|Optional|
 |iabConsentDialogOverlay|SlotStyle \|undefined|Backdrop overlay rendered behind the IAB dialog.|-|Optional|
 |buttonPrimary|SlotStyle \|undefined|Shared primary button style used across consent components.|-|Optional|
 |buttonSecondary|SlotStyle \|undefined|Shared secondary button style used across consent components.|-|Optional|

package/docs/styling/tokens.md

@@ -6,6 +6,8 @@ description: The six base token categories that control colors, typography, spac
 
 Color tokens define the palette for all consent components. Set `colors` for light mode and `dark` for dark mode overrides.
 
+When `textOnPrimary` is omitted, c15t derives it automatically from `primary` to keep text readable on primary-filled surfaces such as stock branding tags and buttons. Set `textOnPrimary` explicitly when you need a specific foreground color.
+
 ```tsx
 const theme = {
   colors: {
@@ -45,7 +47,7 @@ const theme = {
 |borderHover|string \|undefined|Hover state for bordered elements.|-|Optional|
 |text|string \|undefined|Primary text color for headings and body.|-|Optional|
 |textMuted|string \|undefined|Muted text color for secondary content.|-|Optional|
-|textOnPrimary|string \|undefined|Text color for content on primary background.|-|Optional|
+|textOnPrimary|string \|undefined|Text color for content on primary background. Auto-derived from \`primary\` when omitted.|-|Optional|
 |overlay|string \|undefined|Overlay color for modal backdrops.|-|Optional|
 |switchTrack|string \|undefined|Toggle track color (off state).|-|Optional|
 |switchTrackActive|string \|undefined|Toggle track color (on state).|-|Optional|

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@c15t/react",
-	"version": "2.0.0-rc.8",
+	"version": "2.0.0",
 	"description": "Developer-first CMP for React: cookie banner, consent manager, preferences centre. GDPR ready with minimal setup and rich customization",
 	"keywords": [
 		"react",
@@ -25,7 +25,7 @@
 		"url": "https://github.com/c15t/c15t.git",
 		"directory": "packages/react"
 	},
-	"license": "GPL-3.0-only",
+	"license": "Apache-2.0",
 	"sideEffects": [
 		"**/*.css"
 	],
@@ -164,14 +164,13 @@
 		"not op_mini all"
 	],
 	"dependencies": {
-		"@c15t/ui": "2.0.0-rc.8",
-		"c15t": "2.0.0-rc.8",
-		"clsx": "2.1.1"
+		"@c15t/ui": "2.0.0",
+		"c15t": "2.0.0"
 	},
 	"devDependencies": {
-		"@c15t/backend": "2.0.0-rc.8",
-		"@c15t/iab": "2.0.0-rc.8",
-		"@c15t/typescript-config": "0.0.1-beta.1",
+		"@c15t/backend": "2.0.0",
+		"@c15t/iab": "2.0.0",
+		"@c15t/typescript-config": "0.0.1",
 		"@c15t/vitest-config": "1.0.0",
 		"@iabtechlabtcf/core": "^1.5.20",
 		"genversion": "3.2.0",