sud-ui 1.9.0 → 1.9.1

package/dist/theme/ThemeContext.d.ts

@@ -0,0 +1,42 @@
+import type { Context, FC, ReactNode } from "react";
+
+export type ThemeScale = Record<string | number, string>;
+
+export interface ComponentColorToken {
+  bg?: string;
+  txt?: string;
+  border?: string;
+  separator?: string;
+  text?: string;
+  now?: string;
+  [key: string]: unknown;
+}
+
+export interface SUDTheme {
+  body?: {
+    backgroundColor?: string;
+    color?: string;
+    [key: string]: unknown;
+  };
+  colors?: Record<string, ThemeScale>;
+  components?: Record<string, Record<string, ComponentColorToken>>;
+  typography?: {
+    fontSize?: Record<string, string>;
+    fontWeight?: Record<string, string | number>;
+    [key: string]: unknown;
+  };
+  shadows?: Record<string, string>;
+  shapes?: Record<string, Record<string, string | number>>;
+  [key: string]: unknown;
+}
+
+export interface ThemeProviderProps {
+  theme?: SUDTheme;
+  darkTheme?: SUDTheme;
+  isDarkMode?: boolean;
+  children?: ReactNode;
+}
+
+export declare const ThemeContext: Context<SUDTheme | null>;
+export declare const useTheme: () => SUDTheme;
+export declare const ThemeProvider: FC<ThemeProviderProps>;

package/dist/theme/darkTheme.d.ts

@@ -0,0 +1,3 @@
+import type { SUDTheme } from "./ThemeContext";
+
+export declare const darkTheme: SUDTheme;

package/dist/theme/defaultTheme.d.ts

@@ -0,0 +1,3 @@
+import type { SUDTheme } from "./ThemeContext";
+
+export declare const defaultTheme: SUDTheme;

package/dist/theme/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./ThemeContext.d";
+export * from "./defaultTheme.d";
+export * from "./darkTheme.d";
+export * from "./themeUtils.d";

package/dist/theme/themeUtils.d.ts

@@ -0,0 +1,80 @@
+import type { shadowType, surfaceType } from "../components/commonType";
+import type { SUDTheme } from "./ThemeContext";
+
+export interface ComputeColorStylesOptions {
+  theme?: SUDTheme;
+  border?: boolean;
+  fallback?: string;
+  componentType?: string;
+}
+
+export interface ColorStyleResult {
+  bgColor?: string;
+  txtColor?: string;
+  borColor?: string | null;
+  separator?: string;
+  text?: string;
+  now?: string;
+}
+
+export interface ParsedColorString {
+  color?: string;
+  intensity?: number;
+}
+
+export interface ResolveSurfaceStyleOptions {
+  surface?: surfaceType;
+  border?: boolean;
+  shadow?: shadowType | boolean | null;
+}
+
+export interface ResolvedSurfaceStyle {
+  border: boolean;
+  shadow: shadowType;
+}
+
+export declare const computeColorStyles: (
+  options?: ComputeColorStylesOptions
+) => ColorStyleResult;
+export declare const parseColorString: (colorString?: string) => ParsedColorString;
+export declare const resolveColor: (
+  colorString?: string,
+  theme?: SUDTheme
+) => string;
+export declare const adjustBrightness: (hex: string, percent: number) => string;
+export declare const getColorWithIntensity: (
+  color: string,
+  intensity?: number,
+  theme?: SUDTheme
+) => string;
+export declare const mergeClassNames: (
+  ...args: Array<string | false | null | undefined>
+) => string;
+export declare const normalizeShadow: (
+  shadow?: shadowType | boolean | null | ""
+) => shadowType;
+export declare const surfacePresets: Record<
+  surfaceType,
+  { border: boolean; shadow: shadowType }
+>;
+export declare const resolveSurfaceStyle: (
+  options?: ResolveSurfaceStyleOptions
+) => ResolvedSurfaceStyle;
+export declare const getShadowStyle: (
+  shadow?: shadowType | boolean | null,
+  theme?: SUDTheme
+) => string;
+export declare const getShapeStyles: (
+  shape?: string,
+  theme?: SUDTheme
+) => Record<string, string | number>;
+export declare const getFontStyles: (options: {
+  size?: string;
+  weight?: string;
+  theme: SUDTheme;
+}) => {
+  fontSize: string;
+  fontWeight: string | number;
+};
+export declare const applyPulseEffect: (element: HTMLElement) => void;
+export declare const pulseThumbScaleWithBounce: (element: HTMLElement) => void;

package/docs/surface-guidelines.md

@@ -0,0 +1,29 @@
+# Surface Guidelines
+
+Sud UI components should not enable border and shadow at the same time by default.
+
+## Defaults
+
+- Content and form surfaces use a border by default and no shadow.
+- Floating surfaces use a shadow by default and no border.
+- Action components such as `Button` stay flat by default unless the caller asks for a shadow.
+
+## Component Types
+
+- `content`: `Card`, `Collapse`, dense layout panels
+- `input`: `Input`, `Select`, form controls
+- `floating`: `Modal`, `Drawer`, `PopupBase`, `Dropdown`, overlays
+- `action`: `Button`, icon buttons, compact commands
+
+Use `surface`, `border`, and `shadow` to override these defaults explicitly.
+
+## Release Check
+
+Before publishing, run:
+
+```bash
+npm run lint
+npm run build
+npm run check:exports
+npm pack --dry-run
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sud-ui",
   "description": "A React UI component library with dark mode support, customizable styles, reusable components, and utility-style class names.",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,11 +16,13 @@
     "./dist/index.css": "./dist/index.css"
   },
   "files": [
-    "dist"
+    "dist",
+    "docs"
   ],
   "scripts": {
     "dev": "vite",
     "build": "vite build && node scripts/copy-types.mjs",
+    "check:exports": "node scripts/check-exports.mjs",
     "lint": "eslint .",
     "preview": "vite preview"
   },