@riverbankcms/sdk 0.60.1 → 0.60.6

package/dist/_dts/ui/src/palette/PaletteTokenEditor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * One palette role slot. `name` is intentionally a free string here so the
+ * component can be reused for theme palettes that predate the closed
+ * `PaletteTokenName` union; callers pass the role-label mapping via `roles`.
+ */
+export type PaletteToken = Readonly<{
+    name: string;
+    hex: string;
+}>;
+export type PaletteRole = Readonly<{
+    key: string;
+    label: string;
+}>;
+export declare const DEFAULT_BRAND_ROLES: ReadonlyArray<PaletteRole>;
+export declare const DEFAULT_FEEDBACK_ROLES: ReadonlyArray<PaletteRole>;
+export declare const DEFAULT_SURFACE_ROLES: ReadonlyArray<PaletteRole>;
+export type PaletteTokenEditorProps = Readonly<{
+    /**
+     * Current palette colours. Only entries whose `name` matches one of the
+     * configured role keys are surfaced; extra entries pass through untouched.
+     */
+    palette: ReadonlyArray<PaletteToken>;
+    /**
+     * Called when the user edits a role's hex via the picker or the input
+     * field. The editor filters implausible strings and forwards a canonical
+     * lowercase `#RRGGBB` value via `normalizeHex`; the handler can merge
+     * the value into its store without further normalisation.
+     */
+    onChange: (role: string, hex: string) => void;
+    /**
+     * Optional invalid-palette banner — shown when the consumer wants to
+     * surface schema errors (e.g. from a Zod parse failure) without coupling
+     * the editor to a validation context.
+     */
+    hasInvalidValues?: boolean;
+    /** Override the default role groupings (e.g. to add `primaryForeground`). */
+    brandRoles?: ReadonlyArray<PaletteRole>;
+    feedbackRoles?: ReadonlyArray<PaletteRole>;
+    surfaceRoles?: ReadonlyArray<PaletteRole>;
+    showContrastChecks?: boolean;
+    className?: string;
+}>;
+/**
+ * Shared palette role grid + contrast checker. Self-contained: no theme-
+ * editor / validation context dependencies. Used by:
+ *   - Macadamia onboarding (advanced colour panel, planned)
+ *   - LiveThemeEditor's palette tab (via a thin context wrapper)
+ *   - Style configurator's brand-colours row
+ */
+export declare function PaletteTokenEditor({ palette, onChange, hasInvalidValues, brandRoles, feedbackRoles, surfaceRoles, showContrastChecks, className, }: PaletteTokenEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/ui/src/palette/hex.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Hex colour helpers shared by every palette-editing surface (Macadamia
+ * onboarding swatches, the LiveThemeEditor, the Style configurator advanced
+ * row). Consolidates three prior duplicates: `normalizeColorPickerValue` in
+ * Macadamia, `normalizeHex` + `contrastRatio` in `theme-editor/utils.ts`, and
+ * the inline regex in `updateColorRole`.
+ *
+ * Pure functions; no DOM, no React.
+ */
+/**
+ * Coerces user input into a canonical lowercase `#RRGGBB` form. Accepts
+ * 3-digit shorthand, case-insensitive 6-digit hex, and the same forms with or
+ * without a leading `#`; returns `fallback` for any other shape (empty
+ * string, garbage, characters outside `[0-9a-f]`, wrong length, etc.). Pass
+ * a `fallback` to make the fallback explicit at the call site — defaulting
+ * to `'#000000'` keeps the legacy `theme-editor/utils.ts` semantics.
+ */
+export declare function normalizeHex(input: string | null | undefined, fallback?: string): string;
+/**
+ * WCAG relative luminance + contrast ratio. Rounded to 2 decimal places so
+ * the result is stable for UI display.
+ */
+export declare function contrastRatio(hexA: string, hexB: string): number;

package/dist/_dts/ui/src/palette/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @riverbankcms/ui/palette — shared palette-editing primitives.
+ *
+ * Consolidates three palette-editing surfaces that had drifted in the
+ * dashboard: Macadamia onboarding's colour chooser, the LiveThemeEditor's
+ * palette tab, and the Style configurator's brand-colours panel. Each
+ * component is self-contained (no context coupling) and built on
+ * Riverbank UI primitives so it works in any client tree.
+ */
+export { ColorSwatchButton, type ColorSwatchButtonProps } from './ColorSwatchButton';
+export { ColorSlotButton, type ColorSlotButtonProps } from './ColorSlotButton';
+export { ColorChooserDialog, type ColorChooserDialogProps, type ColorChooserSwatch, } from './ColorChooserDialog';
+export { PaletteTokenEditor, type PaletteTokenEditorProps, type PaletteToken, type PaletteRole, DEFAULT_BRAND_ROLES, DEFAULT_FEEDBACK_ROLES, DEFAULT_SURFACE_ROLES, } from './PaletteTokenEditor';
+export { contrastRatio, normalizeHex } from './hex';