gantri-components 2.246.6 → 2.247.0

package/dist/components/text-field/text-field-surface-context.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import { TextFieldSurface } from './text-field.types';
+/**
+ * Lets a parent (typically a `Modal` with `surface="dynamic"`) propagate
+ * the surface treatment to all `TextField` / `Dropdown` / `SearchField` /
+ * `TextArea` descendants without the consumer having to set `surface`
+ * on every input.
+ *
+ * Resolution order (TextField reads): explicit `surface` prop → context
+ * value → undefined (falls back to theme-based legacy behavior).
+ */
+export declare const TextFieldSurfaceContext: import("react").Context<TextFieldSurface | undefined>;

package/dist/components/text-field/text-field.styles.d.ts

@@ -4,5 +4,9 @@ export declare const StyledParentContainer: import("styled-components/dist/types
 export declare const StyledInputContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, StyledInputContainerProps>> & string;
 export declare const StyledInput: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, never>> & string;
 export declare const StyledFloatingInputWrap: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
-export declare const StyledFloatingLabel: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, never>> & string;
-export declare const StyledFloatingLabelOptional: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, never>> & string;
+export declare const StyledFloatingLabel: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>, {
+    $surface?: "flat" | "dynamic" | undefined;
+}>> & string;
+export declare const StyledFloatingLabelOptional: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {
+    $surface?: "flat" | "dynamic" | undefined;
+}>> & string;

package/dist/components/text-field/text-field.types.d.ts

@@ -11,6 +11,23 @@ export type ErrorMessageType = string | {
 };
 export type TextFieldSize = 'small' | 'medium' | 'large';
 export type TextFieldVariant = 'line' | 'filled';
+/**
+ * Container fill / text treatment, independent of theme. Mirrors the
+ * Figma GDS 3.0 input surface variants:
+ *
+ * - `'flat'` — solid `rgba(0,0,0,0.07)` tint, near-black text. Use over
+ *   light page backgrounds in any theme.
+ * - `'dynamic'` — frosted-glass luminosity blend (`rgba(204,204,204,0.13)`)
+ *   with white text. Designed for inputs over photography / dark imagery
+ *   (e.g. inside a `Modal surface="dynamic"`).
+ *
+ * Leave `surface` undefined to inherit from the nearest
+ * `TextFieldSurfaceContext` provider (a `Modal surface="dynamic"`
+ * automatically broadcasts `'dynamic'` to its descendants). When neither
+ * prop nor context are set, falls back to the legacy theme-based
+ * behavior (modern-dark looks Dynamic, others look Flat).
+ */
+export type TextFieldSurface = 'flat' | 'dynamic';
 export type LabelPosition = 'top' | 'left' | 'floating';
 export interface TextFieldProps {
     ariaLabel?: string;
@@ -67,6 +84,13 @@ export interface TextFieldProps {
     size?: ResolutionAwareProp<TextFieldSize>;
     step?: string | number | undefined;
     style?: CSSProperties;
+    /**
+     * Visual surface variant. See `TextFieldSurface` for details. When
+     * omitted, the input inherits from `TextFieldSurfaceContext` (set
+     * automatically by `Modal surface="dynamic"`), and ultimately falls
+     * back to theme-based behavior.
+     */
+    surface?: TextFieldSurface;
     throttle?: number;
     type?: HTMLInputTypeAttribute | undefined;
     value?: string;
@@ -83,6 +107,7 @@ export interface StyledInputContainerProps extends Pick<TextFieldProps, 'variant
     $disabled: boolean;
     $floating?: boolean;
     $size?: ResolutionAwareProp<TextFieldSize>;
+    $surface?: TextFieldSurface;
     $withErrors: boolean;
 }
 export interface StyledParentContainerProps extends Pick<TextFieldProps, 'labelPosition' | 'marginTop' | 'marginRight' | 'marginBottom' | 'marginLeft' | 'horizontalMargin' | 'verticalMargin' | 'margin'> {