@opensite/ui 2.6.4 → 2.6.6

package/dist/utils.d.ts

@@ -1,10 +1,10 @@
 import { ClassValue } from 'clsx';
-import { S as SectionBackground } from './community-initiatives-yvApKT-I.js';
+import { S as SectionBackground } from './community-initiatives-Cz9FycbA.js';
 import 'react';
 import 'react/jsx-runtime';
-import './blocks-D9BXWpQN.js';
+import './blocks-BJ3CyHu6.js';
 import 'class-variance-authority';
-import './button-variants-8mtEHxev.js';
+import './button-variants-lRElsmTc.js';
 import 'class-variance-authority/types';
 import '@opensite/hooks/usePlatformFromUrl';
 
@@ -185,6 +185,64 @@ declare function getTextColor(parentBg?: SectionBackground, variant?: TextColorV
 declare function getAccentColor(parentBg?: SectionBackground, options?: {
     override?: string;
 }): string;
+/**
+ * Determines if a Section background variant is "dark" (requires light text).
+ *
+ * This utility identifies backgrounds that use light-colored text (text-background,
+ * text-primary-foreground, etc.) where nested content may need inverted styling.
+ *
+ * **Dark backgrounds:**
+ * - `dark`: Uses `bg-foreground text-background`
+ * - `gradient`: Uses `text-primary-foreground`
+ * - `primary`: Uses `text-primary-foreground`
+ * - `secondary`: Uses `text-secondary-foreground` (typically light on dark secondary)
+ *
+ * @param bg - The Section's background variant
+ * @returns true if the background is dark and requires light text
+ *
+ * @example
+ * if (isDarkBackground(background)) {
+ *   // Apply inverted styling
+ * }
+ */
+declare function isDarkBackground(bg?: SectionBackground): boolean;
+/**
+ * Get the appropriate prose classes based on parent Section background.
+ *
+ * This utility provides **context-aware prose styling** that ensures typography
+ * content remains readable regardless of the Section's background color.
+ *
+ * **How it works:**
+ * - On **dark backgrounds** (dark, gradient, primary, secondary): Uses `prose-invert`
+ *   directly to ensure light text on dark backgrounds
+ * - On **light backgrounds**: Uses `dark:prose-invert` so prose inverts only in
+ *   system/page dark mode
+ *
+ * **Required:** The `@tailwindcss/typography` plugin must be installed.
+ *
+ * @param parentBg - The parent Section's background variant
+ * @param additionalClasses - Additional prose modifier classes (e.g., "prose-sm", "max-w-none")
+ * @returns Tailwind prose class string
+ *
+ * @example
+ * // Basic usage in a block component
+ * <div className={cn(getProseClassName(background), "mx-auto max-w-3xl")}>
+ *   {children}
+ * </div>
+ *
+ * @example
+ * // With additional prose modifiers
+ * <div className={cn(getProseClassName(background, "prose-sm max-w-none"))}>
+ *   {children}
+ * </div>
+ *
+ * @example
+ * // In ArticleHeroProse
+ * <div className={cn(getProseClassName(background), proseClassName)}>
+ *   {children}
+ * </div>
+ */
+declare function getProseClassName(parentBg?: SectionBackground, additionalClasses?: string): string;
 /**
  * Border color variant types for dynamic theming
  */
@@ -225,4 +283,4 @@ declare function getBorderColor(parentBg?: SectionBackground, variant?: BorderCo
     override?: string;
 }): string;
 
-export { BRIGHTNESS_CLASS_MAP, type BorderColorVariant, type NestedCardBgOptions, type NestedCardVariant, type TextColorVariant, cn, getAccentColor, getBorderColor, getNestedCardBg, getNestedCardTextColor, getTextColor };
+export { BRIGHTNESS_CLASS_MAP, type BorderColorVariant, type NestedCardBgOptions, type NestedCardVariant, type TextColorVariant, cn, getAccentColor, getBorderColor, getNestedCardBg, getNestedCardTextColor, getProseClassName, getTextColor, isDarkBackground };

package/dist/utils.js

@@ -82,6 +82,13 @@ function getAccentColor(parentBg, options) {
   const isDark = parentBg === "dark" || parentBg === "secondary" || parentBg === "primary";
   return isDark ? "text-accent-foreground" : "text-primary";
 }
+function isDarkBackground(bg) {
+  return bg === "dark" || bg === "gradient" || bg === "primary" || bg === "secondary";
+}
+function getProseClassName(parentBg, additionalClasses) {
+  const baseClasses = isDarkBackground(parentBg) ? "prose prose-invert" : "prose dark:prose-invert";
+  return additionalClasses ? `${baseClasses} ${additionalClasses}` : baseClasses;
+}
 function getBorderColor(parentBg, variant = "default", options) {
   if (options?.override) return options.override;
   const isDark = parentBg === "dark" || parentBg === "secondary" || parentBg === "primary";
@@ -106,4 +113,4 @@ function getBorderColor(parentBg, variant = "default", options) {
   }
 }
 
-export { BRIGHTNESS_CLASS_MAP, cn, getAccentColor, getBorderColor, getNestedCardBg, getNestedCardTextColor, getTextColor };
+export { BRIGHTNESS_CLASS_MAP, cn, getAccentColor, getBorderColor, getNestedCardBg, getNestedCardTextColor, getProseClassName, getTextColor, isDarkBackground };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensite/ui",
-  "version": "2.6.4",
+  "version": "2.6.6",
   "description": "Foundational UI component library for OpenSite Semantic Site Builder with tree-shakable exports and abstract styling",
   "keywords": [
     "react",