@bsuite/ui 0.2.0 → 0.3.0

package/README.md

@@ -30,6 +30,113 @@ import { DotPattern } from '@bsuite/ui'
 Colour control via Tailwind `text-*` utilities or inline `[color:var(...)]`
 (dots use `fill="currentColor"`).
 
+### `Logo`
+
+Slot-aware, theme-aware, branding-aware logo component for all BSuite apps.
+
+```tsx
+import { Logo } from '@bsuite/ui'
+
+<Logo slot="header" colorScheme="auto" />
+```
+
+### `D2CDefaultLogo`
+
+Inline D2C Neon Electric SVG logo (no asset dependency).
+
+```tsx
+import { D2CDefaultLogo } from '@bsuite/ui'
+
+<D2CDefaultLogo className="h-8 w-auto" />
+```
+
+## Branding Components (v0.3.0+)
+
+### `OklchColorPicker`
+
+A color input component for OKLCH color format (BSuite standard).
+
+```tsx
+import { OklchColorPicker } from '@bsuite/ui'
+
+<OklchColorPicker
+  value="oklch(0.546 0.215 262.9)"
+  onChange={(value) => console.log(value)}
+  label="Primary Color"
+  description="Your brand's primary color in OKLCH format"
+/>
+```
+
+**Features:**
+- Live color preview
+- Input fields for L (lightness), C (chroma), H (hue)
+- Slider controls for easy adjustment
+- Validation of OKLCH format
+- Accessible labels and error messages
+
+### `ColorEditorSheet`
+
+A sheet/dialog for editing branding colors with a slot-based color editor.
+
+```tsx
+import { ColorEditorSheet, OklchColorPicker } from '@bsuite/ui'
+
+<ColorEditorSheet
+  open={isOpen}
+  onOpenChange={setIsOpen}
+  title="Edit Primary Color"
+  description="Adjust the OKLCH color values"
+  value="oklch(0.546 0.215 262.9)"
+  onSave={(value) => updateBranding('primary', value)}
+  renderEditor={(props) => <OklchColorPicker {...props} />}
+/>
+```
+
+**Features:**
+- Slide-out sheet interface
+- Slot-based color editor (inject your own picker)
+- Save/Cancel actions
+- Responsive design
+- Accessible dialog implementation
+
+### `BrandingCard`
+
+A card component for displaying and editing tenant branding configuration.
+
+```tsx
+import { BrandingCard, OklchColorPicker } from '@bsuite/ui'
+
+<BrandingCard
+  branding={{
+    primary: "oklch(0.546 0.215 262.9)",
+    accent: "oklch(0.769 0.132 191.7)",
+    logo_url: "https://example.com/logo.svg",
+    company_name: "Acme Corp"
+  }}
+  onUpdate={async (key, value) => {
+    await updateTenantBranding(key, value)
+  }}
+  renderColorEditor={(props) => <OklchColorPicker {...props} />}
+/>
+```
+
+**Features:**
+- Display current branding values (colors, logos, company name)
+- Edit buttons for each branding property
+- Integrated color editing with ColorEditorSheet
+- Image preview for logos
+- Accessible and responsive design
+- Support for light/dark mode logo variants
+
+**Branding Properties:**
+- `primary` - Primary action color (OKLCH)
+- `accent` - Accent/secondary color (OKLCH)
+- `logo_url` - Main logo URL
+- `logo_light_url` - Light mode logo variant (optional)
+- `logo_dark_url` - Dark mode logo variant (optional)
+- `favicon_url` - Favicon URL (16x16 or 32x32)
+- `company_name` - Company name for alt text
+
 ## Utils
 
 ### `cn(...classes)`
@@ -38,6 +145,27 @@ shadcn-style className merger — `clsx` + `tailwind-merge`. Available for
 consumers that want to compose `@bsuite/ui` components with local overrides
 without pulling shadcn again.
 
+## Module Exports
+
+The package provides subpath exports for better tree-shaking:
+
+```tsx
+// Main exports
+import { Logo, BrandingCard } from '@bsuite/ui'
+
+// Dot pattern only
+import { DotPattern } from '@bsuite/ui/dot-pattern'
+
+// Utils only
+import { cn } from '@bsuite/ui/utils'
+
+// Branding components only
+import { BrandingCard, ColorEditorSheet, OklchColorPicker } from '@bsuite/ui/branding'
+
+// SVG asset
+import logoSvg from '@bsuite/ui/assets/d2c-default-logo.svg'
+```
+
 ## Releases
 
 1. Edit source under `src/`.

package/dist/branding/BrandingCard.d.ts

@@ -0,0 +1,56 @@
+/**
+ * BrandingCard — A card component for displaying and editing branding settings
+ *
+ * This component provides a UI for viewing and editing tenant branding
+ * configuration, including colors, logos, and other brand properties.
+ *
+ * Features:
+ * - Display current branding values
+ * - Edit buttons for each branding property
+ * - Integration with ColorEditorSheet for color editing
+ * - Accessible and responsive design
+ * - Supports OKLCH color format
+ *
+ * Usage:
+ *   <BrandingCard
+ *     branding={{
+ *       primary: "oklch(0.546 0.215 262.9)",
+ *       accent: "oklch(0.769 0.132 191.7)",
+ *       logo_url: "https://example.com/logo.svg"
+ *     }}
+ *     onUpdate={(key, value) => console.log('Updated:', key, value)}
+ *     renderColorEditor={(props) => <OklchColorPicker {...props} />}
+ *   />
+ */
+import { type ReactNode } from 'react';
+export interface BrandingCardProps {
+    /** Current branding configuration */
+    branding: {
+        primary?: string;
+        accent?: string;
+        logo_url?: string;
+        logo_light_url?: string;
+        logo_dark_url?: string;
+        favicon_url?: string;
+        company_name?: string;
+        font_stack?: string | null;
+    };
+    /** Callback when a branding property is updated */
+    onUpdate: (key: string, value: string) => void | Promise<void>;
+    /** Render function for the color editor component */
+    renderColorEditor: (props: {
+        value: string;
+        onChange: (value: string) => void;
+        disabled?: boolean;
+    }) => ReactNode;
+    /** Optional className for the card */
+    className?: string;
+    /** Whether editing is disabled */
+    disabled?: boolean;
+    /** Optional title for the card */
+    title?: string;
+    /** Optional description for the card */
+    description?: string;
+}
+export declare function BrandingCard({ branding, onUpdate, renderColorEditor, className, disabled, title, description, }: BrandingCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BrandingCard.d.ts.map

package/dist/branding/BrandingCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrandingCard.d.ts","sourceRoot":"","sources":["../../src/branding/BrandingCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAGhD,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,QAAQ,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,CAAA;IACD,mDAAmD;IACnD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,qDAAqD;IACrD,iBAAiB,EAAE,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;QACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,KAAK,SAAS,CAAA;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AASD,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,QAAgB,EAChB,KAAwB,EACxB,WAAW,GACZ,EAAE,iBAAiB,2CA8QnB"}

package/dist/branding/BrandingCard.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * BrandingCard — A card component for displaying and editing branding settings
+ *
+ * This component provides a UI for viewing and editing tenant branding
+ * configuration, including colors, logos, and other brand properties.
+ *
+ * Features:
+ * - Display current branding values
+ * - Edit buttons for each branding property
+ * - Integration with ColorEditorSheet for color editing
+ * - Accessible and responsive design
+ * - Supports OKLCH color format
+ *
+ * Usage:
+ *   <BrandingCard
+ *     branding={{
+ *       primary: "oklch(0.546 0.215 262.9)",
+ *       accent: "oklch(0.769 0.132 191.7)",
+ *       logo_url: "https://example.com/logo.svg"
+ *     }}
+ *     onUpdate={(key, value) => console.log('Updated:', key, value)}
+ *     renderColorEditor={(props) => <OklchColorPicker {...props} />}
+ *   />
+ */
+import { useState } from 'react';
+import { cn } from '../utils.js';
+export function BrandingCard({ branding, onUpdate, renderColorEditor, className, disabled = false, title = 'Brand Settings', description, }) {
+    const [colorEditor, setColorEditor] = useState({
+        open: false,
+        field: '',
+        label: '',
+        value: '',
+    });
+    const openColorEditor = (field, label, currentValue) => {
+        setColorEditor({
+            open: true,
+            field,
+            label,
+            value: currentValue || '',
+        });
+    };
+    const closeColorEditor = () => {
+        setColorEditor(prev => ({ ...prev, open: false }));
+    };
+    const handleColorSave = async (value) => {
+        await onUpdate(colorEditor.field, value);
+        closeColorEditor();
+    };
+    const handleTextUpdate = async (field, value) => {
+        await onUpdate(field, value);
+    };
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: cn('rounded-lg border border-input bg-card text-card-foreground shadow-sm', className), children: [_jsxs("div", { className: "border-b border-border px-6 py-4", children: [_jsx("h3", { className: "text-lg font-semibold", children: title }), description && (_jsx("p", { className: "mt-1 text-sm text-muted-foreground", children: description }))] }), _jsxs("div", { className: "divide-y divide-border", children: [_jsxs("div", { className: "flex items-center justify-between px-6 py-4", children: [_jsxs("div", { className: "flex items-center gap-4", children: [_jsx("div", { className: "h-10 w-10 rounded border border-input shadow-sm", style: { backgroundColor: branding.primary || 'oklch(0.546 0.215 262.9)' }, "aria-label": "Primary color preview" }), _jsxs("div", { children: [_jsx("div", { className: "font-medium", children: "Primary Color" }), _jsx("div", { className: "text-sm text-muted-foreground", children: branding.primary || 'Not set' })] })] }), _jsx("button", { type: "button", onClick: () => openColorEditor('primary', 'Primary Color', branding.primary || 'oklch(0.546 0.215 262.9)'), disabled: disabled, className: cn('rounded-md border border-input bg-background px-4 py-2 text-sm font-medium', 'hover:bg-accent hover:text-accent-foreground', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:cursor-not-allowed disabled:opacity-50'), children: "Edit" })] }), _jsxs("div", { className: "flex items-center justify-between px-6 py-4", children: [_jsxs("div", { className: "flex items-center gap-4", children: [_jsx("div", { className: "h-10 w-10 rounded border border-input shadow-sm", style: { backgroundColor: branding.accent || 'oklch(0.769 0.132 191.7)' }, "aria-label": "Accent color preview" }), _jsxs("div", { children: [_jsx("div", { className: "font-medium", children: "Accent Color" }), _jsx("div", { className: "text-sm text-muted-foreground", children: branding.accent || 'Not set' })] })] }), _jsx("button", { type: "button", onClick: () => openColorEditor('accent', 'Accent Color', branding.accent || 'oklch(0.769 0.132 191.7)'), disabled: disabled, className: cn('rounded-md border border-input bg-background px-4 py-2 text-sm font-medium', 'hover:bg-accent hover:text-accent-foreground', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:cursor-not-allowed disabled:opacity-50'), children: "Edit" })] }), _jsxs("div", { className: "flex flex-col gap-2 px-6 py-4", children: [_jsx("label", { htmlFor: "company-name", className: "font-medium", children: "Company Name" }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("input", { id: "company-name", type: "text", value: branding.company_name || '', onChange: (e) => handleTextUpdate('company_name', e.target.value), disabled: disabled, placeholder: "Enter company name", className: cn('flex-1 rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50') }) }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Used in logo alt text and other branding contexts" })] }), _jsxs("div", { className: "flex flex-col gap-2 px-6 py-4", children: [_jsx("label", { htmlFor: "logo-url", className: "font-medium", children: "Logo URL" }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("input", { id: "logo-url", type: "url", value: branding.logo_url || '', onChange: (e) => handleTextUpdate('logo_url', e.target.value), disabled: disabled, placeholder: "https://example.com/logo.svg", className: cn('flex-1 rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50') }) }), branding.logo_url && (_jsx("div", { className: "mt-2 flex items-center gap-2", children: _jsx("img", { src: branding.logo_url, alt: "Logo preview", className: "h-12 object-contain", onError: (e) => {
+                                                e.currentTarget.style.display = 'none';
+                                            } }) }))] }), _jsxs("div", { className: "flex flex-col gap-2 px-6 py-4", children: [_jsx("label", { htmlFor: "logo-light-url", className: "font-medium", children: "Logo URL (Light Mode)" }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("input", { id: "logo-light-url", type: "url", value: branding.logo_light_url || '', onChange: (e) => handleTextUpdate('logo_light_url', e.target.value), disabled: disabled, placeholder: "https://example.com/logo-light.svg", className: cn('flex-1 rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50') }) }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Optional: Use a different logo for light mode" })] }), _jsxs("div", { className: "flex flex-col gap-2 px-6 py-4", children: [_jsx("label", { htmlFor: "logo-dark-url", className: "font-medium", children: "Logo URL (Dark Mode)" }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("input", { id: "logo-dark-url", type: "url", value: branding.logo_dark_url || '', onChange: (e) => handleTextUpdate('logo_dark_url', e.target.value), disabled: disabled, placeholder: "https://example.com/logo-dark.svg", className: cn('flex-1 rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50') }) }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Optional: Use a different logo for dark mode" })] }), _jsxs("div", { className: "flex flex-col gap-2 px-6 py-4", children: [_jsx("label", { htmlFor: "favicon-url", className: "font-medium", children: "Favicon URL" }), _jsx("div", { className: "flex items-center gap-2", children: _jsx("input", { id: "favicon-url", type: "url", value: branding.favicon_url || '', onChange: (e) => handleTextUpdate('favicon_url', e.target.value), disabled: disabled, placeholder: "https://example.com/favicon.ico", className: cn('flex-1 rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50') }) }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Square icon shown in browser tabs (16x16 or 32x32)" })] })] })] }), colorEditor.open && (_jsx(ColorEditorSheetWrapper, { open: colorEditor.open, title: `Edit ${colorEditor.label}`, description: "Adjust the OKLCH color values using the sliders below", value: colorEditor.value, onSave: handleColorSave, onCancel: closeColorEditor, renderEditor: renderColorEditor }))] }));
+}
+function ColorEditorSheetWrapper({ open, title, description, value, onSave, onCancel, renderEditor, }) {
+    const [editValue, setEditValue] = useState(value);
+    const [hasChanges, setHasChanges] = useState(false);
+    const handleChange = (newValue) => {
+        setEditValue(newValue);
+        setHasChanges(newValue !== value);
+    };
+    const handleSave = () => {
+        onSave(editValue);
+    };
+    if (!open)
+        return null;
+    return (_jsxs("div", { className: "fixed inset-0 z-50 flex", role: "dialog", "aria-modal": "true", "aria-labelledby": "color-editor-title", "aria-describedby": "color-editor-description", children: [_jsx("div", { className: "fixed inset-0 bg-background/80 backdrop-blur-sm", onClick: onCancel, "aria-hidden": "true" }), _jsxs("div", { className: "fixed inset-y-0 right-0 z-50 flex w-full flex-col border-l bg-background shadow-lg sm:max-w-md", children: [_jsxs("div", { className: "flex items-center justify-between border-b px-6 py-4", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("h2", { id: "color-editor-title", className: "text-lg font-semibold text-foreground", children: title }), _jsx("p", { id: "color-editor-description", className: "text-sm text-muted-foreground", children: description })] }), _jsx("button", { type: "button", onClick: onCancel, className: cn('rounded-sm opacity-70 ring-offset-background transition-opacity', 'hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2'), "aria-label": "Close", children: _jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", className: "h-4 w-4", children: [_jsx("path", { d: "M18 6 6 18" }), _jsx("path", { d: "m6 6 12 12" })] }) })] }), _jsx("div", { className: "flex-1 overflow-y-auto px-6 py-6", children: renderEditor({
+                            value: editValue,
+                            onChange: handleChange,
+                        }) }), _jsxs("div", { className: "flex items-center justify-end gap-2 border-t px-6 py-4", children: [_jsx("button", { type: "button", onClick: onCancel, className: cn('inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium', 'border border-input bg-background hover:bg-accent hover:text-accent-foreground', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2'), children: "Cancel" }), _jsx("button", { type: "button", onClick: handleSave, disabled: !hasChanges, className: cn('inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium', 'bg-primary text-text-on-primary hover:bg-primary/90', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:cursor-not-allowed disabled:opacity-50'), children: "Save Changes" })] })] })] }));
+}

package/dist/branding/ColorEditorSheet.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ColorEditorSheet — A sheet/dialog for editing branding colors
+ *
+ * This component provides a slide-out sheet interface for editing
+ * color values. It uses a slot-based design for the color editor
+ * to allow consumers to inject their own color picker implementation
+ * (e.g., OklchColorPicker, or a custom one).
+ *
+ * Features:
+ * - Slot-based color editor (renderEditor prop)
+ * - Save/Cancel actions
+ * - Accessible dialog implementation
+ * - Responsive design
+ *
+ * Usage:
+ *   <ColorEditorSheet
+ *     open={isOpen}
+ *     onOpenChange={setIsOpen}
+ *     title="Edit Primary Color"
+ *     value="oklch(0.546 0.215 262.9)"
+ *     onSave={(value) => console.log('Saved:', value)}
+ *     renderEditor={(props) => <OklchColorPicker {...props} />}
+ *   />
+ *
+ * Note: Consumers must have shadcn Sheet component installed:
+ *   npx shadcn@latest add sheet
+ */
+import { type ReactNode } from 'react';
+export interface ColorEditorSheetProps {
+    /** Whether the sheet is open */
+    open: boolean;
+    /** Callback when open state changes */
+    onOpenChange: (open: boolean) => void;
+    /** Sheet title */
+    title?: string;
+    /** Description text */
+    description?: string;
+    /** Current color value */
+    value: string;
+    /** Callback when Save is clicked */
+    onSave: (value: string) => void;
+    /** Callback when Cancel is clicked (optional, defaults to closing sheet) */
+    onCancel?: () => void;
+    /** Render function for the color editor component */
+    renderEditor: (props: {
+        value: string;
+        onChange: (value: string) => void;
+        disabled?: boolean;
+    }) => ReactNode;
+    /** Optional className for the sheet content */
+    className?: string;
+    /** Whether save button should be disabled */
+    disabled?: boolean;
+}
+/**
+ * ColorEditorSheet - Generic sheet for editing colors
+ *
+ * This is a "bring your own Sheet" component. Consumers must:
+ * 1. Have shadcn Sheet installed in their app
+ * 2. Pass this component to their app-specific Sheet wrapper
+ *
+ * For consumers WITHOUT shadcn Sheet, they can use this as a
+ * regular dialog/modal by wrapping it in their own dialog primitive.
+ *
+ * Internal implementation uses basic HTML + Tailwind for flexibility.
+ */
+export declare function ColorEditorSheet({ open, onOpenChange, title, description, value, onSave, onCancel, renderEditor, className, disabled, }: ColorEditorSheetProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=ColorEditorSheet.d.ts.map

package/dist/branding/ColorEditorSheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorEditorSheet.d.ts","sourceRoot":"","sources":["../../src/branding/ColorEditorSheet.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG3D,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,uCAAuC;IACvC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,qDAAqD;IACrD,YAAY,EAAE,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;QACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,KAAK,SAAS,CAAA;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,YAAY,EACZ,KAAoB,EACpB,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,QAAgB,GACjB,EAAE,qBAAqB,kDAuIvB"}

package/dist/branding/ColorEditorSheet.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ColorEditorSheet — A sheet/dialog for editing branding colors
+ *
+ * This component provides a slide-out sheet interface for editing
+ * color values. It uses a slot-based design for the color editor
+ * to allow consumers to inject their own color picker implementation
+ * (e.g., OklchColorPicker, or a custom one).
+ *
+ * Features:
+ * - Slot-based color editor (renderEditor prop)
+ * - Save/Cancel actions
+ * - Accessible dialog implementation
+ * - Responsive design
+ *
+ * Usage:
+ *   <ColorEditorSheet
+ *     open={isOpen}
+ *     onOpenChange={setIsOpen}
+ *     title="Edit Primary Color"
+ *     value="oklch(0.546 0.215 262.9)"
+ *     onSave={(value) => console.log('Saved:', value)}
+ *     renderEditor={(props) => <OklchColorPicker {...props} />}
+ *   />
+ *
+ * Note: Consumers must have shadcn Sheet component installed:
+ *   npx shadcn@latest add sheet
+ */
+import { useState, useEffect } from 'react';
+import { cn } from '../utils.js';
+/**
+ * ColorEditorSheet - Generic sheet for editing colors
+ *
+ * This is a "bring your own Sheet" component. Consumers must:
+ * 1. Have shadcn Sheet installed in their app
+ * 2. Pass this component to their app-specific Sheet wrapper
+ *
+ * For consumers WITHOUT shadcn Sheet, they can use this as a
+ * regular dialog/modal by wrapping it in their own dialog primitive.
+ *
+ * Internal implementation uses basic HTML + Tailwind for flexibility.
+ */
+export function ColorEditorSheet({ open, onOpenChange, title = 'Edit Color', description, value, onSave, onCancel, renderEditor, className, disabled = false, }) {
+    const [editValue, setEditValue] = useState(value);
+    const [hasChanges, setHasChanges] = useState(false);
+    useEffect(() => {
+        if (open) {
+            setEditValue(value);
+            setHasChanges(false);
+        }
+    }, [open, value]);
+    const handleChange = (newValue) => {
+        setEditValue(newValue);
+        setHasChanges(newValue !== value);
+    };
+    const handleSave = () => {
+        onSave(editValue);
+        onOpenChange(false);
+    };
+    const handleCancel = () => {
+        if (onCancel) {
+            onCancel();
+        }
+        onOpenChange(false);
+    };
+    if (!open)
+        return null;
+    return (_jsxs("div", { className: "fixed inset-0 z-50 flex", role: "dialog", "aria-modal": "true", "aria-labelledby": "color-editor-title", "aria-describedby": description ? 'color-editor-description' : undefined, children: [_jsx("div", { className: "fixed inset-0 bg-background/80 backdrop-blur-sm", onClick: handleCancel, "aria-hidden": "true" }), _jsxs("div", { className: "fixed inset-y-0 right-0 z-50 flex w-full flex-col border-l bg-background shadow-lg sm:max-w-md", children: [_jsxs("div", { className: "flex items-center justify-between border-b px-6 py-4", children: [_jsxs("div", { className: "space-y-1", children: [_jsx("h2", { id: "color-editor-title", className: "text-lg font-semibold text-foreground", children: title }), description && (_jsx("p", { id: "color-editor-description", className: "text-sm text-muted-foreground", children: description }))] }), _jsx("button", { type: "button", onClick: handleCancel, className: cn('rounded-sm opacity-70 ring-offset-background transition-opacity', 'hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:pointer-events-none'), "aria-label": "Close", disabled: disabled, children: _jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", className: "h-4 w-4", children: [_jsx("path", { d: "M18 6 6 18" }), _jsx("path", { d: "m6 6 12 12" })] }) })] }), _jsx("div", { className: cn('flex-1 overflow-y-auto px-6 py-6', className), children: renderEditor({
+                            value: editValue,
+                            onChange: handleChange,
+                            disabled,
+                        }) }), _jsxs("div", { className: "flex items-center justify-end gap-2 border-t px-6 py-4", children: [_jsx("button", { type: "button", onClick: handleCancel, disabled: disabled, className: cn('inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium', 'border border-input bg-background hover:bg-accent hover:text-accent-foreground', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:cursor-not-allowed disabled:opacity-50'), children: "Cancel" }), _jsx("button", { type: "button", onClick: handleSave, disabled: disabled || !hasChanges, className: cn('inline-flex items-center justify-center rounded-md px-4 py-2 text-sm font-medium', 'bg-primary text-text-on-primary hover:bg-primary/90', 'focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2', 'disabled:cursor-not-allowed disabled:opacity-50'), children: "Save Changes" })] })] })] }));
+}

package/dist/branding/OklchColorPicker.d.ts

@@ -0,0 +1,18 @@
+export interface OklchColorPickerProps {
+    /** Current OKLCH color value, e.g. "oklch(0.546 0.215 262.9)" */
+    value?: string;
+    /** Callback when color changes */
+    onChange?: (value: string) => void;
+    /** Label for the color picker */
+    label?: string;
+    /** Whether the input is disabled */
+    disabled?: boolean;
+    /** Optional className for the container */
+    className?: string;
+    /** Optional description/helper text */
+    description?: string;
+    /** Optional error message */
+    error?: string;
+}
+export declare function OklchColorPicker({ value, onChange, label, disabled, className, description, error, }: OklchColorPickerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OklchColorPicker.d.ts.map

package/dist/branding/OklchColorPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OklchColorPicker.d.ts","sourceRoot":"","sources":["../../src/branding/OklchColorPicker.tsx"],"names":[],"mappings":"AAyBA,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA+BD,wBAAgB,gBAAgB,CAAC,EAC/B,KAA0B,EAC1B,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,SAAS,EACT,WAAW,EACX,KAAK,GACN,EAAE,qBAAqB,2CA8LvB"}

package/dist/branding/OklchColorPicker.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * OklchColorPicker — A color input component for OKLCH color format
+ *
+ * OKLCH is the BSuite standard color format for the D2C Neon Electric theme.
+ * This component provides a user-friendly interface for editing OKLCH colors
+ * with visual preview and validation.
+ *
+ * Features:
+ * - Live preview of the selected color
+ * - Input fields for L (lightness), C (chroma), H (hue)
+ * - Validation of OKLCH format
+ * - Accessible labels and error messages
+ *
+ * Usage:
+ *   <OklchColorPicker
+ *     value="oklch(0.546 0.215 262.9)"
+ *     onChange={(value) => console.log(value)}
+ *     label="Primary Color"
+ *   />
+ */
+import { useState, useEffect } from 'react';
+import { cn } from '../utils.js';
+const OKLCH_RE = /^oklch\(\s*[\d.]+%?\s+[\d.]+%?\s+[\d.]+%?(?:\s*\/\s*[\d.]+%?)?\s*\)$/i;
+function parseOklch(value) {
+    if (!value || !OKLCH_RE.test(value))
+        return null;
+    const match = value.match(/oklch\(\s*([\d.]+)%?\s+([\d.]+)%?\s+([\d.]+)%?(?:\s*\/\s*([\d.]+)%?)?\s*\)/i);
+    if (!match)
+        return null;
+    return {
+        l: parseFloat(match[1]),
+        c: parseFloat(match[2]),
+        h: parseFloat(match[3]),
+        alpha: match[4] ? parseFloat(match[4]) : undefined,
+    };
+}
+function formatOklch(components) {
+    const { l, c, h, alpha } = components;
+    if (alpha !== undefined && alpha !== 1) {
+        return `oklch(${l} ${c} ${h} / ${alpha})`;
+    }
+    return `oklch(${l} ${c} ${h})`;
+}
+export function OklchColorPicker({ value = 'oklch(0.5 0.1 0)', onChange, label, disabled = false, className, description, error, }) {
+    const parsed = parseOklch(value);
+    const [components, setComponents] = useState(parsed || { l: 0.5, c: 0.1, h: 0 });
+    const [inputValue, setInputValue] = useState(value);
+    const [isValid, setIsValid] = useState(true);
+    useEffect(() => {
+        const newParsed = parseOklch(value);
+        if (newParsed) {
+            setComponents(newParsed);
+            setInputValue(value);
+            setIsValid(true);
+        }
+    }, [value]);
+    const handleComponentChange = (key, val) => {
+        const numVal = parseFloat(val);
+        if (isNaN(numVal))
+            return;
+        const newComponents = { ...components, [key]: numVal };
+        setComponents(newComponents);
+        const formatted = formatOklch(newComponents);
+        setInputValue(formatted);
+        setIsValid(true);
+        onChange?.(formatted);
+    };
+    const handleRawInputChange = (e) => {
+        const newValue = e.target.value;
+        setInputValue(newValue);
+        const newParsed = parseOklch(newValue);
+        if (newParsed) {
+            setComponents(newParsed);
+            setIsValid(true);
+            onChange?.(newValue);
+        }
+        else {
+            setIsValid(false);
+        }
+    };
+    return (_jsxs("div", { className: cn('space-y-3', className), children: [label && (_jsx("label", { className: "text-sm font-medium text-foreground", children: label })), description && (_jsx("p", { className: "text-sm text-muted-foreground", children: description })), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("div", { className: "h-12 w-12 rounded-md border-2 border-input shadow-sm", style: { backgroundColor: inputValue }, "aria-label": "Color preview" }), _jsx("div", { className: "flex-1", children: _jsx("input", { type: "text", value: inputValue, onChange: handleRawInputChange, disabled: disabled, className: cn('w-full rounded-md border border-input bg-background px-3 py-2 text-sm', 'focus:outline-none focus:ring-2 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50', !isValid && 'border-destructive'), placeholder: "oklch(0.5 0.1 0)", "aria-label": "OKLCH color value", "aria-invalid": !isValid }) })] }), _jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "grid grid-cols-[80px_1fr_60px] items-center gap-2", children: [_jsx("label", { htmlFor: "oklch-l", className: "text-sm text-muted-foreground", children: "L (Light)" }), _jsx("input", { id: "oklch-l", type: "range", min: "0", max: "1", step: "0.01", value: components.l, onChange: (e) => handleComponentChange('l', e.target.value), disabled: disabled, className: "cursor-pointer disabled:cursor-not-allowed disabled:opacity-50", "aria-label": "Lightness" }), _jsx("input", { type: "number", min: "0", max: "1", step: "0.01", value: components.l.toFixed(2), onChange: (e) => handleComponentChange('l', e.target.value), disabled: disabled, className: cn('w-full rounded border border-input bg-background px-2 py-1 text-sm', 'focus:outline-none focus:ring-1 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50'), "aria-label": "Lightness value" })] }), _jsxs("div", { className: "grid grid-cols-[80px_1fr_60px] items-center gap-2", children: [_jsx("label", { htmlFor: "oklch-c", className: "text-sm text-muted-foreground", children: "C (Chroma)" }), _jsx("input", { id: "oklch-c", type: "range", min: "0", max: "0.4", step: "0.001", value: components.c, onChange: (e) => handleComponentChange('c', e.target.value), disabled: disabled, className: "cursor-pointer disabled:cursor-not-allowed disabled:opacity-50", "aria-label": "Chroma" }), _jsx("input", { type: "number", min: "0", max: "0.4", step: "0.001", value: components.c.toFixed(3), onChange: (e) => handleComponentChange('c', e.target.value), disabled: disabled, className: cn('w-full rounded border border-input bg-background px-2 py-1 text-sm', 'focus:outline-none focus:ring-1 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50'), "aria-label": "Chroma value" })] }), _jsxs("div", { className: "grid grid-cols-[80px_1fr_60px] items-center gap-2", children: [_jsx("label", { htmlFor: "oklch-h", className: "text-sm text-muted-foreground", children: "H (Hue)" }), _jsx("input", { id: "oklch-h", type: "range", min: "0", max: "360", step: "0.1", value: components.h, onChange: (e) => handleComponentChange('h', e.target.value), disabled: disabled, className: "cursor-pointer disabled:cursor-not-allowed disabled:opacity-50", "aria-label": "Hue" }), _jsx("input", { type: "number", min: "0", max: "360", step: "0.1", value: components.h.toFixed(1), onChange: (e) => handleComponentChange('h', e.target.value), disabled: disabled, className: cn('w-full rounded border border-input bg-background px-2 py-1 text-sm', 'focus:outline-none focus:ring-1 focus:ring-ring', 'disabled:cursor-not-allowed disabled:opacity-50'), "aria-label": "Hue value" })] })] }), (error || !isValid) && (_jsx("p", { className: "text-sm text-destructive", children: error || 'Invalid OKLCH format. Expected: oklch(L C H) where L is 0-1, C is 0-0.4, H is 0-360' }))] }));
+}

package/dist/branding/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @bsuite/ui/branding — branding components
+ */
+export { BrandingCard, type BrandingCardProps } from './BrandingCard.js';
+export { ColorEditorSheet, type ColorEditorSheetProps } from './ColorEditorSheet.js';
+export { OklchColorPicker, type OklchColorPickerProps } from './OklchColorPicker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/branding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/branding/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/branding/index.js

@@ -0,0 +1,6 @@
+/**
+ * @bsuite/ui/branding — branding components
+ */
+export { BrandingCard } from './BrandingCard.js';
+export { ColorEditorSheet } from './ColorEditorSheet.js';
+export { OklchColorPicker } from './OklchColorPicker.js';

package/dist/index.d.ts

@@ -2,4 +2,5 @@ export { DotPattern, type DotPatternProps } from './dot-pattern.js';
 export { cn } from './utils.js';
 export { Logo, resolveLogoUrl, type LogoProps, type LogoSlot, type LogoColorScheme, type LogoBranding, type ResolvedLogo, type AppSlug, } from './Logo.js';
 export { D2CDefaultLogo, type D2CDefaultLogoProps } from './default-logo.js';
+export { BrandingCard, ColorEditorSheet, OklchColorPicker, type BrandingCardProps, type ColorEditorSheetProps, type OklchColorPickerProps, } from './branding/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EACL,IAAI,EACJ,cAAc,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,OAAO,GACb,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EACL,IAAI,EACJ,cAAc,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,OAAO,GACb,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG5E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -2,3 +2,5 @@ export { DotPattern } from './dot-pattern.js';
 export { cn } from './utils.js';
 export { Logo, resolveLogoUrl, } from './Logo.js';
 export { D2CDefaultLogo } from './default-logo.js';
+// Branding components (v0.3.0+)
+export { BrandingCard, ColorEditorSheet, OklchColorPicker, } from './branding/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bsuite/ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -31,6 +31,10 @@
       "import": "./dist/utils.js",
       "types": "./dist/utils.d.ts"
     },
+    "./branding": {
+      "import": "./dist/branding/index.js",
+      "types": "./dist/branding/index.d.ts"
+    },
     "./assets/d2c-default-logo.svg": "./src/assets/d2c-default-logo.svg"
   },
   "scripts": {