@riverbankcms/sdk 0.60.3 → 0.60.7

package/dist/_dts/theme-core/src/site-styles/styleTags.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+/**
+ * Descriptive style-axis metadata for button personalities and palette
+ * variants. Site Style picker shape is curated explicitly; these tags remain
+ * for catalog audit, docs, and future discovery tooling.
+ */
+export declare const STYLE_AXIS_VALUES: {
+    readonly tone: readonly ["minimal", "classic", "bold"];
+    readonly energy: readonly ["calm", "vibrant"];
+    readonly motion: readonly ["subtle", "standard", "expressive"];
+    readonly era: readonly ["editorial", "modern", "organic", "technical", "retro"];
+};
+export declare const styleTagsSchema: z.ZodObject<{
+    tone: z.ZodOptional<z.ZodEnum<{
+        bold: "bold";
+        minimal: "minimal";
+        classic: "classic";
+    }>>;
+    energy: z.ZodOptional<z.ZodEnum<{
+        calm: "calm";
+        vibrant: "vibrant";
+    }>>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        subtle: "subtle";
+        expressive: "expressive";
+    }>>;
+    era: z.ZodOptional<z.ZodEnum<{
+        editorial: "editorial";
+        modern: "modern";
+        retro: "retro";
+        technical: "technical";
+        organic: "organic";
+    }>>;
+}, z.core.$strip>;
+export type StyleTone = (typeof STYLE_AXIS_VALUES.tone)[number];
+export type StyleEnergy = (typeof STYLE_AXIS_VALUES.energy)[number];
+export type StyleMotion = (typeof STYLE_AXIS_VALUES.motion)[number];
+export type StyleEra = (typeof STYLE_AXIS_VALUES.era)[number];
+export type StyleAxis = Readonly<{
+    tone: StyleTone;
+    energy: StyleEnergy;
+    motion: StyleMotion;
+    era: StyleEra;
+}>;
+export type StyleTags = Readonly<Partial<StyleAxis>>;

package/dist/_dts/theme-core/src/site-styles/tokenRecipes.d.ts

@@ -18,14 +18,14 @@ export declare const themeTokenRecipesSchema: z.ZodObject<{
     }>;
     contrast: z.ZodEnum<{
         standard: "standard";
-        strong: "strong";
         maximum: "maximum";
+        strong: "strong";
     }>;
     radius: z.ZodEnum<{
-        rounded: "rounded";
+        soft: "soft";
         square: "square";
+        rounded: "rounded";
         pill: "pill";
-        soft: "soft";
     }>;
     shadow: z.ZodEnum<{
         none: "none";
@@ -39,9 +39,9 @@ export declare const themeTokenRecipesSchema: z.ZodObject<{
         "friendly-sans": "friendly-sans";
     }>;
     spacing: z.ZodEnum<{
-        compact: "compact";
-        regular: "regular";
         airy: "airy";
+        regular: "regular";
+        compact: "compact";
     }>;
     motion: z.ZodEnum<{
         none: "none";

package/dist/_dts/ui/src/badge.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "success" | "secondary" | "outline" | "default" | "warning" | "destructive" | null | undefined;
+    variant?: "success" | "default" | "warning" | "secondary" | "destructive" | "outline" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/_dts/ui/src/button-group.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import { Separator } from './separator';
 declare const buttonGroupVariants: (props?: ({
-    orientation?: "vertical" | "horizontal" | null | undefined;
+    orientation?: "horizontal" | "vertical" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function ButtonGroup({ className, orientation, ...props }: React.ComponentProps<'div'> & VariantProps<typeof buttonGroupVariants>): import("react/jsx-runtime").JSX.Element;
 declare function ButtonGroupText({ className, asChild, ...props }: React.ComponentProps<'div'> & {

package/dist/_dts/ui/src/button.d.ts

@@ -1,8 +1,8 @@
 import { type VariantProps } from 'class-variance-authority';
 import * as React from 'react';
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "secondary" | "outline" | "default" | "destructive" | "ghost" | "onDark" | "onDarkOutline" | "heroGlass" | null | undefined;
-    size?: "default" | "sm" | "lg" | "icon" | null | undefined;
+    variant?: "link" | "default" | "secondary" | "destructive" | "outline" | "ghost" | "onDark" | "onDarkOutline" | "heroGlass" | null | undefined;
+    size?: "default" | "lg" | "sm" | "icon" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
     asChild?: boolean;

package/dist/_dts/ui/src/callout.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const calloutVariants: (props?: ({
-    tone?: "success" | "default" | "warning" | "info" | "danger" | null | undefined;
+    tone?: "success" | "default" | "warning" | "danger" | "info" | null | undefined;
     layout?: "inline" | "banner" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CalloutProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof calloutVariants> & {

package/dist/_dts/ui/src/card.d.ts

@@ -4,7 +4,7 @@ import { surfaceVariants } from './surface';
 export type CardVariant = VariantProps<typeof surfaceVariants>['variant'];
 export type CardRadius = VariantProps<typeof surfaceVariants>['radius'];
 declare const cardLayoutVariants: (props?: ({
-    size?: "none" | "compact" | "default" | "responsive" | null | undefined;
+    size?: "default" | "none" | "compact" | "responsive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CardSize = VariantProps<typeof cardLayoutVariants>['size'];
 export type CardProps = React.ComponentProps<'div'> & {

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

@@ -0,0 +1,47 @@
+/**
+ * Optional pre-set swatch passed to the chooser. Macadamia onboarding feeds
+ * logo-extracted colours here; the LiveThemeEditor and Style configurator
+ * pass an empty array (or omit the prop) so the dialog just exposes the
+ * freeform colour picker.
+ */
+export type ColorChooserSwatch = Readonly<{
+    hex: string;
+    label: string;
+}>;
+export type ColorChooserDialogProps = Readonly<{
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Current persisted value for the slot being edited. */
+    currentValue: string | null;
+    /** Suggested-swatch grid. Empty/omitted => freeform picker only. */
+    swatches?: ReadonlyArray<ColorChooserSwatch>;
+    /**
+     * Swatches in `swatches` that should render as visibly disabled
+     * (typically: already used elsewhere in the palette). Selecting one of
+     * these is still possible if it matches `currentValue`.
+     */
+    disabledHexes?: ReadonlyArray<string>;
+    /**
+     * Fallback hex used when neither `currentValue` nor `swatches[0]` resolve
+     * to a usable colour. Defaults to `#000000`; pass the brand colour if you
+     * want the dialog to open on it.
+     */
+    defaultValue?: string;
+    /** Localised dialog title. */
+    title?: string;
+    /** Localised body description. Falls back to a swatches-aware default. */
+    description?: string;
+    /** Confirm button label. Defaults to "Use this colour". */
+    confirmLabel?: string;
+    /** Optional remove handler. When provided, a "Remove colour" button appears. */
+    onRemove?: () => void;
+    /** Remove button label. Defaults to "Remove colour". */
+    removeLabel?: string;
+    onChoose: (value: string) => void;
+}>;
+/**
+ * Shared colour-chooser dialog. Combines an optional logo-derived swatch
+ * grid with a freeform `ColorPicker` + hex display. Consolidates the
+ * implementations that previously lived inline in Macadamia onboarding.
+ */
+export declare function ColorChooserDialog({ open, onOpenChange, currentValue, swatches, disabledHexes, defaultValue, title, description, confirmLabel, onRemove, removeLabel, onChoose, }: ColorChooserDialogProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * Slot affordance for "this row holds a colour, click to choose". Renders as
+ * an empty dashed-border tile when `value` is null, or as a filled swatch
+ * with the hex displayed when a value is set. Used in the Macadamia
+ * onboarding's primary/secondary colour rows and the Style configurator's
+ * advanced palette panel.
+ */
+export type ColorSlotButtonProps = Readonly<{
+    value: string | null;
+    emptyLabel: string;
+    ariaLabel: string;
+    onClick: () => void;
+    className?: string;
+}>;
+export declare function ColorSlotButton({ value, emptyLabel, ariaLabel, onClick, className }: ColorSlotButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * Compact swatch + label tile. Used in the colour-chooser dialog's
+ * "from your logo" grid and anywhere a palette-aware single-colour row is
+ * needed (Macadamia onboarding's brand colour rows, the Style configurator
+ * advanced palette panel).
+ */
+export type ColorSwatchButtonProps = Readonly<{
+    hex: string;
+    label: string;
+    selected: boolean;
+    onClick: () => void;
+    disabled?: boolean;
+    className?: string;
+}>;
+export declare function ColorSwatchButton({ hex, label, selected, onClick, disabled, className }: ColorSwatchButtonProps): import("react/jsx-runtime").JSX.Element;

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';

package/dist/_dts/ui/src/surface.d.ts

@@ -2,8 +2,8 @@ import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 export declare const surfaceVariants: (props?: ({
     variant?: "default" | "background" | null | undefined;
-    radius?: "none" | "sm" | "md" | "lg" | "xl" | "flushMobile" | null | undefined;
-    padding?: "none" | "sm" | "md" | "lg" | null | undefined;
+    radius?: "none" | "md" | "lg" | "xl" | "sm" | "flushMobile" | null | undefined;
+    padding?: "none" | "md" | "lg" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type SurfaceProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof surfaceVariants>;
 export declare function Surface({ className, variant, radius, padding, ...props }: SurfaceProps): React.ReactElement;

package/dist/_dts/ui/src/toggle.d.ts

@@ -2,11 +2,11 @@ import * as React from "react";
 import * as TogglePrimitive from "@radix-ui/react-toggle";
 import { type VariantProps } from "class-variance-authority";
 declare const toggleVariants: (props?: ({
-    variant?: "outline" | "default" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "lg" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "outline" | "default" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "lg" | "sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
 export { Toggle, toggleVariants };