@c15t/react 2.0.0-rc.4 → 2.0.0-rc.6

package/{dist → dist-types}/hooks/use-color-scheme.d.ts

@@ -4,4 +4,3 @@ export type ColorScheme = 'light' | 'dark' | 'system' | null;
  * React wrapper for `@c15t/ui` setupColorScheme.
  */
 export declare function useColorScheme(colorScheme?: ColorScheme): void;
-//# sourceMappingURL=use-color-scheme.d.ts.map

package/{dist → dist-types}/hooks/use-component-config.d.ts

@@ -1,4 +1,4 @@
-import type { UIOptions } from '@c15t/ui/theme';
+import type { UIOptions } from '../../../ui/dist-types/theme/index.d.ts';
 /**
  * Subset of UIOptions that can be overridden at the component level.
  *
@@ -52,4 +52,3 @@ export type ResolvedComponentConfig = Required<ComponentConfig>;
  * @public
  */
 export declare function useComponentConfig(localOverrides?: ComponentConfig): ResolvedComponentConfig;
-//# sourceMappingURL=use-component-config.d.ts.map

package/dist-types/hooks/use-consent-dialog-trigger.d.ts

@@ -0,0 +1,10 @@
+export type ConsentDialogTriggerVisibility = 'always' | 'after-consent' | 'never';
+export interface UseConsentDialogTriggerOptions {
+    showWhen?: ConsentDialogTriggerVisibility;
+    onClick?: () => void;
+}
+export interface UseConsentDialogTriggerResult {
+    isVisible: boolean;
+    openDialog: () => void;
+}
+export declare function useConsentDialogTrigger(options?: UseConsentDialogTriggerOptions): UseConsentDialogTriggerResult;

package/{dist → dist-types}/hooks/use-consent-manager.d.ts

@@ -2,7 +2,7 @@
  * @packageDocumentation
  * Hook for accessing and managing consent state.
  */
-import type { ConsentManagerInterface, ConsentStoreState } from 'c15t';
+import type { ConsentManagerInterface, ConsentStoreState } from '../../../core/dist-types/index.d.ts';
 /**
  * Hook for accessing and managing consent state.
  *
@@ -25,4 +25,3 @@ import type { ConsentManagerInterface, ConsentStoreState } from 'c15t';
 export declare function useConsentManager(): ConsentStoreState & {
     manager: ConsentManagerInterface | null;
 };
-//# sourceMappingURL=use-consent-manager.d.ts.map

package/{dist → dist-types}/hooks/use-focus-trap.d.ts

@@ -12,4 +12,3 @@ import { type RefObject } from 'react';
  * @public
  */
 export declare function useFocusTrap(shouldTrap: boolean, containerRef: RefObject<HTMLElement | null> | null): void;
-//# sourceMappingURL=use-focus-trap.d.ts.map

package/dist-types/hooks/use-headless-consent-ui.d.ts

@@ -0,0 +1,46 @@
+import { type PolicyUiAction, type PolicyUiActionDirection, type PolicyUiActionGroup, type PolicyUiProfile } from '../components/shared/libs/policy-actions';
+import { useConsentManager } from './use-consent-manager';
+export type HeadlessConsentSurface = 'banner' | 'dialog';
+export type HeadlessConsentSurfaceAction = PolicyUiAction;
+export type HeadlessConsentWriteAction = 'accept' | 'reject';
+export type HeadlessConsentBannerAction = HeadlessConsentSurfaceAction;
+export type HeadlessConsentDialogAction = HeadlessConsentSurfaceAction;
+export interface HeadlessConsentSurfaceState<TAction extends string = HeadlessConsentSurfaceAction> {
+    allowedActions: TAction[];
+    orderedActions: TAction[];
+    actionGroups: TAction[][];
+    primaryActions: TAction[];
+    layout?: PolicyUiActionGroup[];
+    direction: PolicyUiActionDirection;
+    uiProfile?: PolicyUiProfile;
+    scrollLock?: boolean;
+    hasPolicyHints: boolean;
+    shouldFillActions: boolean;
+    isVisible: boolean;
+}
+export type HeadlessConsentBannerState = HeadlessConsentSurfaceState<HeadlessConsentBannerAction>;
+export type HeadlessConsentDialogState = HeadlessConsentSurfaceState<HeadlessConsentDialogAction>;
+export interface UseHeadlessConsentUIResult {
+    activeUI: ReturnType<typeof useConsentManager>['activeUI'];
+    banner: HeadlessConsentBannerState;
+    dialog: HeadlessConsentDialogState;
+    openBanner: (options?: {
+        force?: boolean;
+    }) => void;
+    openDialog: () => void;
+    closeUI: () => void;
+    performAction: (action: HeadlessConsentWriteAction, options: {
+        surface: HeadlessConsentSurface;
+        uiSource?: string;
+    }) => Promise<void>;
+    performBannerAction: (action: HeadlessConsentWriteAction, options?: {
+        uiSource?: string;
+    }) => Promise<void>;
+    performDialogAction: (action: HeadlessConsentWriteAction, options?: {
+        uiSource?: string;
+    }) => Promise<void>;
+    saveCustomPreferences: (options?: {
+        uiSource?: string;
+    }) => Promise<void>;
+}
+export declare function useHeadlessConsentUI(): UseHeadlessConsentUIResult;

package/dist-types/hooks/use-headless-iab-consent-ui.d.ts

@@ -0,0 +1,41 @@
+import { useConsentManager } from './use-consent-manager';
+export type HeadlessIABPreferenceTab = 'purposes' | 'vendors';
+export type HeadlessIABBannerAction = 'accept' | 'reject' | 'customize';
+export type HeadlessIABDialogAction = 'accept' | 'reject' | 'customize';
+export interface HeadlessIABBannerState {
+    isVisible: boolean;
+    isReady: boolean;
+    vendorCount: number;
+    displayItems: string[];
+    remainingCount: number;
+    scrollLock?: boolean;
+}
+export interface HeadlessIABDialogState {
+    isVisible: boolean;
+    isLoading: boolean;
+    activeTab: HeadlessIABPreferenceTab;
+    scrollLock?: boolean;
+}
+export interface UseHeadlessIABConsentUIResult {
+    activeUI: ReturnType<typeof useConsentManager>['activeUI'];
+    model: ReturnType<typeof useConsentManager>['model'];
+    iab: ReturnType<typeof useConsentManager>['iab'];
+    isIABEnabled: boolean;
+    banner: HeadlessIABBannerState;
+    dialog: HeadlessIABDialogState;
+    openBanner: (options?: {
+        force?: boolean;
+    }) => void;
+    openDialog: (options?: {
+        tab?: HeadlessIABPreferenceTab;
+    }) => void;
+    openPurposesDialog: () => void;
+    openVendorsDialog: () => void;
+    closeUI: () => void;
+    acceptAll: () => Promise<void> | void;
+    rejectAll: () => Promise<void> | void;
+    savePreferences: () => Promise<void> | void;
+    performBannerAction: (action: HeadlessIABBannerAction) => Promise<void> | void;
+    performDialogAction: (action: HeadlessIABDialogAction) => Promise<void> | void;
+}
+export declare function useHeadlessIABConsentUI(): UseHeadlessIABConsentUIResult;

package/{dist → dist-types}/hooks/use-reduced-motion.d.ts

@@ -28,4 +28,3 @@
  * @public
  */
 export declare function useReducedMotion(): boolean;
-//# sourceMappingURL=use-reduced-motion.d.ts.map

package/{dist → dist-types}/hooks/use-scroll-lock.d.ts

@@ -3,4 +3,3 @@
  * React wrapper for `@c15t/ui` setupScrollLock.
  */
 export declare function useScrollLock(shouldLock: boolean): void;
-//# sourceMappingURL=use-scroll-lock.d.ts.map

package/{dist → dist-types}/hooks/use-ssr-status.d.ts

@@ -54,4 +54,3 @@ export interface SSRStatus {
  * @public
  */
 export declare function useSSRStatus(): SSRStatus;
-//# sourceMappingURL=use-ssr-status.d.ts.map

package/{dist → dist-types}/hooks/use-styles.d.ts

@@ -19,4 +19,3 @@ import type { AllThemeKeys, ClassNameStyle, ThemeValue } from '../types/theme';
  * @public
  */
 export declare function useStyles(themeKey: AllThemeKeys, componentStyle?: ThemeValue, themeOverride?: any): ClassNameStyle;
-//# sourceMappingURL=use-styles.d.ts.map

package/{dist → dist-types}/hooks/use-text-direction.d.ts

@@ -3,4 +3,3 @@
  * React wrapper for `@c15t/ui` text direction utilities.
  */
 export declare function useTextDirection(language?: string): "ltr" | "rtl";
-//# sourceMappingURL=use-text-direction.d.ts.map

package/{dist → dist-types}/hooks/use-theme.d.ts

@@ -1,2 +1 @@
 export declare const useTheme: () => import("../context/theme-context").ThemeContextValue;
-//# sourceMappingURL=use-theme.d.ts.map

package/{dist → dist-types}/hooks/use-translations.d.ts

@@ -1,4 +1,4 @@
-import type { Translations } from 'c15t';
+import type { Translations } from '../../../core/dist-types/index.d.ts';
 /**
  * Hook for accessing translations in the current language.
  *
@@ -26,4 +26,3 @@ import type { Translations } from 'c15t';
  * @public
  */
 export declare function useTranslations(): Translations;
-//# sourceMappingURL=use-translations.d.ts.map

package/dist-types/iab.d.ts

@@ -0,0 +1,24 @@
+/**
+ * IAB TCF 2.3 React components and hooks.
+ *
+ * This subpath export contains all IAB-specific React UI. It is only
+ * loaded when explicitly imported from '@c15t/react/iab'.
+ *
+ * Requires `@c15t/iab` as a peer dependency.
+ *
+ * @example
+ * ```tsx
+ * import { iab } from '@c15t/iab';
+ * import { IABConsentBanner, IABConsentDialog } from '@c15t/react/iab';
+ *
+ * <ConsentManagerProvider options={{ mode: 'hosted', iab: iab({ cmpId: 28 }) }}>
+ *   <IABConsentBanner />
+ *   <IABConsentDialog />
+ * </ConsentManagerProvider>
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { IABConsentBanner, type IABConsentBannerProps, } from './components/iab-consent-banner';
+export { IABConsentDialog, type IABConsentDialogProps, } from './components/iab-consent-dialog';
+export { type HeadlessIABBannerAction, type HeadlessIABBannerState, type HeadlessIABDialogAction, type HeadlessIABDialogState, type HeadlessIABPreferenceTab, type UseHeadlessIABConsentUIResult, useHeadlessIABConsentUI, } from './hooks/use-headless-iab-consent-ui';

package/{dist → dist-types}/index.d.ts

@@ -1,5 +1,5 @@
-export type { AllConsentNames, ConsentManagerInterface, ConsentStoreState, ConsentType, Overrides, Translations, } from 'c15t';
-export { configureConsentManager, defaultTranslationConfig, detectBrowserLanguage, mergeTranslationConfigs, prepareTranslationConfig, } from 'c15t';
+export type { AllConsentNames, ConsentManagerInterface, ConsentStoreState, ConsentType, EuropePolicyMode, Overrides, PolicyPackPresets, Translations, } from '../../core/dist-types/index.d.ts';
+export { configureConsentManager, defaultTranslationConfig, detectBrowserLanguage, mergeTranslationConfigs, policyPackPresets, prepareTranslationConfig, } from '../../core/dist-types/index.d.ts';
 export { ConsentBanner, type ConsentBannerProps, } from './components/consent-banner';
 export * from './components/consent-banner/components';
 export { ConsentDialog, type ConsentDialogProps, } from './components/consent-dialog';
@@ -7,15 +7,14 @@ export { ConsentDialogLink, type ConsentDialogLinkProps, } from './components/co
 export { ConsentDialogTrigger, type ConsentDialogTriggerCompound, type ConsentDialogTriggerProps, TriggerButton, type TriggerButtonProps, TriggerIcon, type TriggerIconProps, type TriggerIconType, TriggerRoot, type TriggerRootProps, type TriggerSize, TriggerText, type TriggerTextProps, type TriggerVisibility, type UseDraggableOptions, type UseDraggableReturn, useDraggable, useTriggerContext, } from './components/consent-dialog-trigger';
 export { ConsentWidget, type ConsentWidgetProps, } from './components/consent-widget';
 export { Frame, type FrameProps } from './components/frame';
-export { IABConsentBanner, type IABConsentBannerProps, } from './components/iab-consent-banner';
-export { IABConsentDialog, type IABConsentDialogProps, } from './components/iab-consent-dialog';
 export { ConsentButton } from './components/shared/primitives/button';
 export { useColorScheme } from './hooks/use-color-scheme';
+export { type ConsentDialogTriggerVisibility, type UseConsentDialogTriggerOptions, type UseConsentDialogTriggerResult, useConsentDialogTrigger, } from './hooks/use-consent-dialog-trigger';
 export { useConsentManager } from './hooks/use-consent-manager';
 export { useFocusTrap } from './hooks/use-focus-trap';
+export { type HeadlessConsentBannerAction, type HeadlessConsentBannerState, type HeadlessConsentDialogAction, type HeadlessConsentDialogState, type HeadlessConsentSurface, type HeadlessConsentSurfaceAction, type HeadlessConsentSurfaceState, type HeadlessConsentWriteAction, type UseHeadlessConsentUIResult, useHeadlessConsentUI, } from './hooks/use-headless-consent-ui';
 export { useSSRStatus } from './hooks/use-ssr-status';
 export { useTranslations } from './hooks/use-translations';
 export { ConsentManagerProvider } from './providers/consent-manager-provider';
 export type { ConsentManagerOptions, ConsentManagerProviderProps, } from './types/consent-manager';
 export type { ColorTokens, ComponentSlots, MotionTokens, RadiusTokens, ShadowTokens, SlotStyle, SpacingTokens, Theme, TypographyTokens, } from './types/theme';
-//# sourceMappingURL=index.d.ts.map

package/dist-types/primitives/accordion.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/accordion';

package/dist-types/primitives/button.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/button';

package/dist-types/primitives/collapsible.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/collapsible';

package/dist-types/primitives/dialog.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/dialog';

package/dist-types/primitives/preference-item.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/preference-item';

package/dist-types/primitives/switch.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/switch';

package/dist-types/primitives/tabs.d.ts

@@ -0,0 +1 @@
+export * from '../components/shared/ui/tabs';

package/dist-types/primitives.d.ts

@@ -0,0 +1,7 @@
+export * as Accordion from './components/shared/ui/accordion';
+export * as Button from './components/shared/ui/button';
+export * as Collapsible from './components/shared/ui/collapsible';
+export * as Dialog from './components/shared/ui/dialog';
+export * as PreferenceItem from './components/shared/ui/preference-item';
+export * as Switch from './components/shared/ui/switch';
+export * as Tabs from './components/shared/ui/tabs';

package/{dist → dist-types}/providers/consent-manager-provider.d.ts

@@ -38,4 +38,3 @@ export declare function clearConsentRuntimeCache(): void;
  * @public
  */
 export declare function ConsentManagerProvider({ children, options, }: ConsentManagerProviderProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=consent-manager-provider.d.ts.map

package/{dist → dist-types}/server/fetch-ssr-data.d.ts

@@ -1,4 +1,4 @@
-import type { SSRInitialData } from 'c15t';
+import type { SSRInitialData } from '../../../core/dist-types/index.d.ts';
 import type { FetchSSRDataOptions } from './types';
 /**
  * Fetches initial consent data on the server for SSR hydration.
@@ -40,4 +40,3 @@ import type { FetchSSRDataOptions } from './types';
  * @public
  */
 export declare function fetchSSRData(options: FetchSSRDataOptions): Promise<SSRInitialData | undefined>;
-//# sourceMappingURL=fetch-ssr-data.d.ts.map

package/{dist → dist-types}/server/headers.d.ts

@@ -1,4 +1,4 @@
-declare const FORWARDED_HEADERS: readonly ["cf-ipcountry", "x-vercel-ip-country", "x-amz-cf-ipcountry", "x-country-code", "x-vercel-ip-country-region", "x-region-code", "accept-language", "user-agent", "x-forwarded-host", "x-forwarded-for", "sec-gpc"];
+declare const FORWARDED_HEADERS: readonly ["cf-ipcountry", "x-vercel-ip-country", "x-amz-cf-ipcountry", "x-country-code", "x-vercel-ip-country-region", "x-region-code", "accept-language", "user-agent", "x-forwarded-host", "x-forwarded-for", "sec-gpc", "purpose", "sec-purpose", "next-router-prefetch", "x-middleware-prefetch"];
 type ForwardedHeader = (typeof FORWARDED_HEADERS)[number] | 'x-c15t-country' | 'x-c15t-region';
 type RelevantHeaders = Partial<Record<ForwardedHeader, string>>;
 /**
@@ -13,6 +13,7 @@ type RelevantHeaders = Partial<Record<ForwardedHeader, string>>;
  * - Country headers (cf-ipcountry, x-vercel-ip-country, etc.)
  * - Region headers (x-vercel-ip-country-region, x-region-code)
  * - Standard headers (accept-language, user-agent, x-forwarded-*)
+ * - Prefetch headers (purpose, sec-purpose, next-router-prefetch, x-middleware-prefetch)
  *
  * @param headersList - The Headers object from the incoming request
  * @returns An object containing the relevant headers for consent management
@@ -29,4 +30,3 @@ type RelevantHeaders = Partial<Record<ForwardedHeader, string>>;
  */
 export declare function extractRelevantHeaders(headersList: Headers): RelevantHeaders;
 export {};
-//# sourceMappingURL=headers.d.ts.map

package/{dist → dist-types}/server/index.d.ts

@@ -26,6 +26,6 @@
  */
 export { fetchSSRData } from './fetch-ssr-data';
 export { extractRelevantHeaders } from './headers';
+export { createSSRInitCacheKey } from './init-cache-key';
 export { normalizeBackendURL, validateBackendURL } from './normalize-url';
 export type { FetchSSRDataOptions, FetchSSRDataOptionsBase, FetchSSRDataResult, } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist-types/server/init-cache-key.d.ts

@@ -0,0 +1,21 @@
+import type { Overrides } from '../../../core/dist-types/index.d.ts';
+/**
+ * Creates a stable cache key for SSR init responses.
+ *
+ * @remarks
+ * This is framework-agnostic and can be used by wrappers (e.g. Next.js)
+ * to align cache key construction with the headers/override semantics used
+ * for SSR init fetching.
+ *
+ * @param normalizedURL - Normalized backend URL for /init
+ * @param headers - Request headers
+ * @param overrides - Optional location/language overrides
+ * @returns A stable JSON string key
+ *
+ * @public
+ */
+export declare function createSSRInitCacheKey({ normalizedURL, headers, overrides, }: {
+    normalizedURL: string;
+    headers: Headers;
+    overrides?: Overrides;
+}): string;

package/{dist → dist-types}/server/normalize-url.d.ts

@@ -49,4 +49,3 @@ export declare function validateBackendURL(backendURL: string): {
  * @public
  */
 export declare function normalizeBackendURL(backendURL: string, headersList: Headers): string | null;
-//# sourceMappingURL=normalize-url.d.ts.map

package/{dist → dist-types}/server/types.d.ts

@@ -1,4 +1,4 @@
-import type { Overrides, SSRInitialData } from 'c15t';
+import type { Overrides, SSRInitialData } from '../../../core/dist-types/index.d.ts';
 /**
  * Base options for SSR data fetching, shared across framework integrations.
  *
@@ -48,4 +48,3 @@ export interface FetchSSRDataOptions extends FetchSSRDataOptionsBase {
  * Result of the SSR data fetch.
  */
 export type FetchSSRDataResult = SSRInitialData | undefined;
-//# sourceMappingURL=types.d.ts.map

package/{dist → dist-types}/types/consent-manager.d.ts

@@ -1,4 +1,4 @@
-import type { BaseConsentManagerOptions, UIOptions } from '@c15t/ui/theme';
+import type { BaseConsentManagerOptions, UIOptions } from '../../../ui/dist-types/theme/index.d.ts';
 import type { ReactNode } from 'react';
 /**
  * React-specific configuration options
@@ -12,6 +12,11 @@ export interface ReactUIOptions extends UIOptions {
  * This type composes:
  * - Base framework-agnostic options from {@link BaseConsentManagerOptions}
  * - React-specific UI configuration
+ *
+ * In offline mode this also includes `offlinePolicy` configuration for
+ * local policy previews.
+ *
+ * @see {@link https://v2.c15t.com/docs/frameworks/react/policy-packs}
  */
 export type ConsentManagerOptions = BaseConsentManagerOptions & ReactUIOptions;
 /**
@@ -27,7 +32,8 @@ export interface ConsentManagerProviderProps {
     /**
      * Configuration options for the consent manager.
      * This includes core, React, store, and translation settings.
+     *
+     * @see {@link https://v2.c15t.com/docs/frameworks/react/components/consent-manager-provider}
      */
     options: ConsentManagerOptions;
 }
-//# sourceMappingURL=consent-manager.d.ts.map

package/{dist → dist-types}/types/theme/index.d.ts

@@ -1,3 +1,2 @@
 export * from './style-keys';
 export * from './style-types';
-//# sourceMappingURL=index.d.ts.map

package/dist-types/types/theme/style-keys.d.ts

@@ -0,0 +1 @@
+export type { AllThemeKeys } from '../../../../ui/dist-types/theme/index.d.ts';

package/{dist → dist-types}/types/theme/style-types.d.ts

@@ -1,7 +1,7 @@
-import type { ClassNameStyle as BaseClassNameStyle, Theme as BaseTheme } from '@c15t/ui/theme';
+import type { ClassNameStyle as BaseClassNameStyle, Theme as BaseTheme } from '../../../../ui/dist-types/theme/index.d.ts';
 import type { CSSProperties } from 'react';
 import type { AllThemeKeys } from './style-keys';
-export type { ColorTokens, ComponentSlots, CSSVariables, MotionTokens, RadiusTokens, ShadowTokens, SlotStyle, SpacingTokens, TypographyTokens, } from '@c15t/ui/theme';
+export type { ColorTokens, ComponentSlots, CSSVariables, MotionTokens, RadiusTokens, ShadowTokens, SlotStyle, SpacingTokens, TypographyTokens, } from '../../../../ui/dist-types/theme/index.d.ts';
 /**
  * Represents CSS properties with optional CSS variables.
  * @public
@@ -33,6 +33,8 @@ export interface ExtendThemeKeys<VariableMap = Record<string, string | number>>
  * @public
  */
 export interface Theme extends Omit<BaseTheme, 'slots'> {
+    /** Semantic button styling for consent actions. */
+    consentActions?: BaseTheme['consentActions'];
     /** Component-specific style overrides. */
     slots?: BaseTheme['slots'];
 }
@@ -41,4 +43,3 @@ export interface Theme extends Omit<BaseTheme, 'slots'> {
  * @public
  */
 export declare function defineTheme<ThemeType extends Theme>(theme: ThemeType): ThemeType;
-//# sourceMappingURL=style-types.d.ts.map

package/{dist → dist-types}/utils/cn.d.ts

@@ -1,7 +1,6 @@
-import type { ClassValue } from '@c15t/ui/utils';
+import type { ClassValue } from '../../../ui/dist-types/utils/index.d.ts';
 export type { ClassValue };
 /**
  * Utilizes framework-agnostic `cn` from @c15t/ui.
  */
 export declare function cnExt(...classes: ClassValue[]): string;
-//# sourceMappingURL=cn.d.ts.map

package/{dist → dist-types}/utils/merge-styles.d.ts

@@ -9,4 +9,3 @@ import type { ClassNameStyle, ThemeValue } from '../types/theme';
  * @returns The merged styles object
  */
 export declare function mergeStyles(style1: ThemeValue, style2?: ThemeValue): ClassNameStyle;
-//# sourceMappingURL=merge-styles.d.ts.map

package/{dist → dist-types}/utils/test-helpers.d.ts

@@ -29,4 +29,3 @@ interface ComponentStyles {
  */
 export declare function testComponentStyles({ component, testCases, noStyle, theme, }: ComponentStyles): Promise<void>;
 export default testComponentStyles;
-//# sourceMappingURL=test-helpers.d.ts.map

package/{dist → dist-types}/utils/theme-utils.d.ts

@@ -2,7 +2,7 @@
  * Utility functions for processing the v2 theme system.
  * Handles token-to-CSS variable conversion and dark mode overrides.
  */
-import type { ThemeCSSVariables } from '@c15t/ui/theme';
+import type { ThemeCSSVariables } from '../../../ui/dist-types/theme/index.d.ts';
 import type { Theme } from '../types/theme/style-types';
 /**
  * Default design tokens for the v2 theme system.
@@ -16,4 +16,3 @@ export declare function themeToVars(theme: Theme, isDark?: boolean): ThemeCSSVar
  * Generates a CSS string for the theme variables.
  */
 export declare function generateThemeCSS(theme: Theme): string;
-//# sourceMappingURL=theme-utils.d.ts.map

package/dist-types/version.d.ts

@@ -0,0 +1 @@
+export declare const version = "2.0.0-rc.6";

package/docs/README.md

@@ -0,0 +1,76 @@
+# c15t React Docs
+
+React-focused c15t docs for consent UI, hooks, headless flows, and script integrations.
+
+If you are changing consent flows, consent UI, script loading, server-side setup, or backend configuration in an app that uses this package, start here before editing code.
+
+## Start Here
+
+- [Quickstart](./quickstart.md)
+- [Headless](./headless.md)
+- [Building Headless Components](./building-headless-components.md)
+- [Callbacks](./callbacks.md)
+- [Google Tag Manager](./integrations/google-tag-manager.md)
+
+## Workflow Rules
+
+### Styling
+
+Use this when:
+- customizing component appearance
+- adapting c15t components to a design system
+- deciding how far to override the default UI
+
+Prefer:
+- Prefer design tokens first.
+- If tokens are not enough, use component slots.
+- Then use CSS variables or `className` for targeted overrides.
+
+If that is not enough:
+- Use `noStyle` or a full headless rebuild only when the design system cannot be expressed through the supported styling layers.
+
+Avoid:
+- Do not rebuild the consent UI from scratch if tokens, slots, or scoped overrides are sufficient.
+
+Read next:
+- [Overview](./styling/overview.md)
+- [Tokens](./styling/tokens.md)
+- [Slots](./styling/slots.md)
+- [Css Variables](./styling/css-variables.md)
+
+### Consent UI Customization
+
+Use this when:
+- changing banners, dialogs, or preference centers
+- deciding between built-in components and headless APIs
+
+Prefer:
+- Prefer the built-in components and their documented customization surfaces first.
+- If the UI requirements diverge significantly, use the headless APIs.
+
+Avoid:
+- Do not rebuild the full consent flow if a token, slot, or component override is enough.
+
+Read next:
+- [Quickstart](./quickstart.md)
+- [Consent Banner](./components/consent-banner.md)
+- [Headless](./headless.md)
+- [Building Headless Components](./building-headless-components.md)
+
+### Scripts & Integrations
+
+Use this when:
+- adding third-party scripts in React components or providers
+- wiring analytics or advertising behind consent
+
+Prefer:
+- Prefer premade scripts from `@c15t/scripts/*`.
+- Start from the integration docs before implementing custom script wiring in React components.
+
+Avoid:
+- Do not duplicate consent-sync logic in React effects when the integration already handles it.
+
+Read next:
+- [Script Loader](./script-loader.md)
+- [Google Tag Manager](./integrations/google-tag-manager.md)
+- [Meta Pixel](./integrations/meta-pixel.md)