// Copyright (c) Meta Platforms, Inc. and affiliates.

'use client';

/**
 * @file Text component exports
 * @position Entry point for Text components
 */

/**
 * Extensible map of text color variants for Text/Heading.
 *
 * Themes add custom colors via component overrides in defineTheme; a custom
 * color renders with the `primary` baseline color from StyleX and receives its
 * actual color from theme CSS (`.astryx-text.<color>` / `.astryx-heading.<color>`),
 * exactly like custom text `type`s.
 *
 * To add type-safe custom colors, use module augmentation — the same technique
 * as `ButtonVariantMap` etc.:
 * ```ts
 * declare module '@astryxdesign/core/Text' {
 *   interface TextColorMap {
 *     brand: true;
 *     danger: true;
 *   }
 * }
 * ```
 *
 * `astryx theme build` generates these augmentations automatically when it
 * detects new `color:*` values in a theme's Text/Heading component overrides.
 */
export interface TextColorMap {
  primary: true;
  secondary: true;
  disabled: true;
  placeholder: true;
  accent: true;
  inherit: true;
}
export { Text, type TextProps, type TextType, type TextSize } from "./Text.js";
export { Heading, type HeadingProps, type HeadingLevel, type HeadingType, type HeadingTypeMap } from "../Heading/index.js";

// Re-export shared types from theme for convenience
export type { TextColor, TextWeight, TextDisplay, TextJustify, WordBreak, TextWrap, TextXStyleAllowed, ProseElement } from "../theme/types.js";

// Re-export useTruncation for advanced use cases
export { useTruncation, type UseTruncationOptions, type UseTruncationReturn } from "./useTruncation.js";