@ceebee/ui 1.4.1 → 1.5.0

package/dist/client.d.ts

@@ -2,22 +2,42 @@ import { ThemeConfig } from 'antd';
 export * from 'antd';
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { createCache } from '@ant-design/cssinjs';
 export { default as enUSLocale } from 'antd/locale/en_US.js';
 export { default as enUSDatePickerLocale } from 'antd/lib/date-picker/locale/en_US.js';
 export { default as idIDLocale } from 'antd/locale/id_ID.js';
 export { default as zhCNLocale } from 'antd/locale/zh_CN.js';
 import * as _base_ui_react from '@base-ui/react';
 
+type CeebeeSkin = 'ceebee' | 'astra' | 'clarity' | 'moodboard';
+type ThemeMode = 'light' | 'dark';
+type ThemeContrast = 'normal' | 'more';
+
 interface ThemeBridgeProps {
     children: ReactNode;
-    mode: 'light' | 'dark';
+    mode: ThemeMode;
+    skin?: CeebeeSkin;
+    contrast?: ThemeContrast;
     theme?: ThemeConfig;
 }
 /**
  * Translates Ceebee's live CSS Tokens into Ant's theme seed. Ant still owns component geometry,
  * interaction, accessibility, and derived tokens; Ceebee owns the active Skin and colour mode.
  */
-declare function ThemeBridge({ children, mode, theme }: ThemeBridgeProps): react.JSX.Element;
+declare function ThemeBridge({ children, mode, skin, contrast, theme, }: ThemeBridgeProps): react.JSX.Element;
+
+type CeebeeAntStyleCache = ReturnType<typeof createCache>;
+/** Creates the Ant CSS-in-JS cache shared by a framework adapter and CeeBee's Ant runtime. */
+declare function createCeebeeAntStyleCache(): CeebeeAntStyleCache;
+/** Extracts only rules not already emitted from a CeeBee-owned Ant style cache. */
+declare function extractCeebeeAntStyles(cache: CeebeeAntStyleCache): string | undefined;
+
+interface CeebeeAntStyleProviderProps {
+    cache: CeebeeAntStyleCache;
+    children: ReactNode;
+}
+/** Binds Ant rendering to the cache owned by the consumer's framework adapter. */
+declare function CeebeeAntStyleProvider({ cache, children }: CeebeeAntStyleProviderProps): react.JSX.Element;
 
 /**
  * Every string the library says out loud. They are here rather than inline because a component
@@ -92,6 +112,19 @@ interface MotionHelpers extends MotionSettings {
 declare function useMotionSettings(): MotionHelpers;
 
 type ThemeChoice = 'light' | 'dark' | 'system';
+interface ThemeProviderProps {
+    children: ReactNode;
+    defaultChoice?: ThemeChoice;
+    /** Resolved mode read by the server, normally via readThemeModeCookie(request Cookie header). */
+    initialMode?: ThemeMode;
+    /** Must match the Skin stylesheet loaded by the application. */
+    skin?: CeebeeSkin;
+    /** Server-known contrast preference. Browsers still refresh from live CSS after mounting. */
+    contrast?: ThemeContrast;
+    persist?: boolean;
+    /** Optional Ant token/component overrides applied after the active Ceebee Skin. */
+    antdTheme?: ThemeConfig;
+}
 interface ThemeState {
     choice: ThemeChoice;
     setChoice: (choice: ThemeChoice) => void;
@@ -99,17 +132,10 @@ interface ThemeState {
     resolved: 'light' | 'dark';
 }
 /**
- * Colour itself comes from CSS, not from here — this only flips `data-theme`
- * on the document root, so the first paint is already correct without a blocking script
- * for anyone who never overrides the system setting.
+ * CSS remains the colour source of truth. This flips `data-theme` and gives Ant the generated seed
+ * for the server-known rendering; after mount ThemeBridge refreshes from the live CSS cascade.
  */
-declare function ThemeProvider({ children, defaultChoice, persist, antdTheme, }: {
-    children: ReactNode;
-    defaultChoice?: ThemeChoice;
-    persist?: boolean;
-    /** Optional Ant token/component overrides applied after the active Ceebee Skin. */
-    antdTheme?: ThemeConfig;
-}): react.JSX.Element;
+declare function ThemeProvider({ children, defaultChoice, initialMode, skin, contrast, persist, antdTheme, }: ThemeProviderProps): react.JSX.Element;
 declare function useTheme(): ThemeState;
 
 /** Command matching and ranking. Pure — search that ranks badly is a bug you can only see in a test. */
@@ -329,4 +355,4 @@ declare const PanZoomCanvas: typeof PanZoomCanvasRoot & {
     Skeleton: typeof PanZoomCanvasSkeleton;
 };
 
-export { Checklist, type ChecklistProps, type ChecklistTask, type Command, CommandPalette, type CommandPaletteProps, DEFAULT_LABELS, type DurationToken, type Labels, LabelsProvider, type LabelsProviderProps, type MotionHelpers, MotionProvider, type MotionProviderProps, type MotionSettings, type NavItem, type NavSection, type PaletteCommand, PanZoomCanvas, type PanZoomCanvasProps, type PanZoomCanvasSkeletonProps, type RankedCommand, Reveal, type RevealProps, Sidebar, type SidebarProps, type SpringPreset, Stagger, type StaggerProps, StickerGroup, type StickerGroupProps, type StickerGroupSkeletonProps, type StickerItem, ThemeBridge, type ThemeBridgeProps, type ThemeChoice, ThemeProvider, type ToastOptions, type ToastPosition, ToastProvider, type ToastProviderProps, TopBar, type TopBarProps, filterCommands, groupCommands, rankCommand, useLabels, useMotionSettings, useTheme, useToast };
+export { type CeebeeAntStyleCache, CeebeeAntStyleProvider, type CeebeeAntStyleProviderProps, Checklist, type ChecklistProps, type ChecklistTask, type Command, CommandPalette, type CommandPaletteProps, DEFAULT_LABELS, type DurationToken, type Labels, LabelsProvider, type LabelsProviderProps, type MotionHelpers, MotionProvider, type MotionProviderProps, type MotionSettings, type NavItem, type NavSection, type PaletteCommand, PanZoomCanvas, type PanZoomCanvasProps, type PanZoomCanvasSkeletonProps, type RankedCommand, Reveal, type RevealProps, Sidebar, type SidebarProps, type SpringPreset, Stagger, type StaggerProps, StickerGroup, type StickerGroupProps, type StickerGroupSkeletonProps, type StickerItem, ThemeBridge, type ThemeBridgeProps, type ThemeChoice, ThemeProvider, type ThemeProviderProps, type ToastOptions, type ToastPosition, ToastProvider, type ToastProviderProps, TopBar, type TopBarProps, createCeebeeAntStyleCache, extractCeebeeAntStyles, filterCommands, groupCommands, rankCommand, useLabels, useMotionSettings, useTheme, useToast };