@ufoui/core 0.0.12 → 0.0.40

package/utils/renderPortal.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode, ReactPortal } from 'react';
+/**
+ * Returns the portal host element `#id`, creating it when missing.
+ *
+ * @remarks
+ * If the element is missing, a `div` with the given `id` is appended to `document.body`.
+ * The portal mounts **into** that host — `document.body` itself is never used as the
+ * direct portal container.
+ *
+ * @param rootId - `id` of the root node (e.g. `'dialog-root'`).
+ *
+ * @returns The host element, or `null` when `document` is unavailable (e.g. SSR).
+ *
+ * @category Utils
+ */
+export declare function ensurePortalRoot(rootId: string): HTMLElement | null;
+/**
+ * Renders children into a dedicated portal root, creating that node when absent.
+ *
+ * @remarks
+ * Uses {@link ensurePortalRoot}; returns `null` when the document is not available.
+ *
+ * @param rootId - `id` of the portal host (e.g. `'dialog-root'`).
+ * @param children - Tree to render into the host.
+ *
+ * @returns A {@link https://react.dev/reference/react-dom/createPortal | React portal}, or `null`.
+ *
+ * @category Utils
+ */
+export declare function renderPortal(rootId: string, children: ReactNode): ReactPortal | null;

package/utils/utils.d.ts

@@ -74,7 +74,7 @@ export type ElementElevation = 0 | 1 | 2 | 3 | 4 | 5;
  *
  * @category Utils
  */
-export type ElementAlign = 'topLeft' | 'topCenter' | 'topRight' | 'centerLeft' | 'center' | 'centerRight' | 'bottomLeft' | 'bottomCenter' | 'bottomRight' | 'topRightOut' | 'topLeftOut' | 'auto';
+export type ElementPlacement = 'topLeft' | 'topCenter' | 'topRight' | 'centerLeft' | 'center' | 'centerRight' | 'bottomLeft' | 'bottomCenter' | 'bottomRight' | 'topRightOut' | 'topLeftOut' | 'auto';
 export type ElementDensity = 'comfortable' | 'compact' | 'dense';
 export type ElementFocusEffect = 'ring' | 'overlay';
 export type ElementPressedEffect = 'elevate' | 'overlay' | 'scale';
@@ -112,7 +112,7 @@ export declare function toKebabCase(str: string): string;
  * @category Utils
  */
 export declare function clampInt(min: number, max: number, value: unknown, fallback?: number): number | undefined;
-export declare const getAlignClass: (position: ElementAlign) => string;
+export declare const getPlacementClass: (position: ElementPlacement) => string;
 /**
  * Returns the appropriate CSS class for the given shape token.
  *

package/utils/generateSchemes.d.ts

@@ -1,32 +0,0 @@
-import { ExtraColorOverrides } from './generateMaterialColors';
-import { PartialThemeSchemes, ThemeSchemes } from '../types';
-/**
- * Generates and injects CSS custom properties for Material Design 3 theme colors.
- *
- * This function calls `generateMaterialColors()` to resolve a complete light/dark
- * `ThemeSchemes` object based on a seed color, optional extra semantic colors
- * (`info`, `warning`, `success`), and optional overrides for individual color tokens.
- *
- * All resolved tokens are converted to CSS variables using kebab-case, e.g.:
- *   `--uui-color-primary`, `--uui-color-on-surface`, etc.
- *
- * Light mode tokens are injected into `:root`, dark mode tokens into `.dark`.
- * Variables are injected once into a single `<style>` tag with ID `ufo-ui-theme`.
- *
- * @param seedColor - The base seed color used to generate MD3 tonal palettes.
- *                    Defaults to `#6750A4` if not provided.
- * @param extraColors - Optional map of base semantic colors for `info`, `warning`, and `success`.
- *                      These override the default values.
- * @param schemes - Optional overrides for light and dark color tokens.
- *                  Partial values will be merged with the generated ones.
- *
- * @returns A fully resolved `ThemeSchemes` object containing all tokens for light and dark modes.
- *
- * @example
- * ```ts
- * const schemes = generateSchemes('#6200ee', { info: '#0288d1' }, { light: { primary: '#ff5722' } });
- * ```
- *
- * @category Theme
- */
-export declare function generateSchemes(seedColor?: string, extraColors?: ExtraColorOverrides, schemes?: PartialThemeSchemes): ThemeSchemes;