@cjlapao/ui-kit 0.2.31 → 0.2.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -69,6 +69,11 @@ declare const TRUE_COLORS: readonly ["red", "orange", "amber", "yellow", "lime",
69
69
  * All components, tokens, and utilities must use TrueColor exclusively.
70
70
  */
71
71
  type TrueColor = (typeof TRUE_COLORS)[number];
72
+ /** Container tint is independent of control/status accent colors. */
73
+ type SurfaceTone = TrueColor | "none";
74
+ declare const SURFACE_TONES: readonly ["none", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "rose", "slate", "gray", "zinc", "neutral", "stone"];
75
+ /** A non-tinted surface still needs a real color for controls and focus cues. */
76
+ declare const getSurfaceAccentColor: (tone: SurfaceTone) => TrueColor;
72
77
  /**
73
78
  * The fill class for a dot/swatch of each TrueColor: the 500 step in light
74
79
  * mode, the 400 step in dark. Literal per colour — never interpolated — so
@@ -269,7 +274,7 @@ declare const FIELD_STATUS_CLASSES: Record<"error" | "success", string>;
269
274
  * (`FormSection`). Kept here so the type and the text that sits on those
270
275
  * surfaces are defined once, not per component.
271
276
  */
272
- declare const SURFACE_VARIANTS: readonly ["elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass"];
277
+ declare const SURFACE_VARIANTS: readonly ["none", "elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass"];
273
278
  type SurfaceVariant = (typeof SURFACE_VARIANTS)[number];
274
279
  /**
275
280
  * The button a card surface implies — what a card CTA wears when it is not
@@ -286,7 +291,7 @@ declare const SURFACE_TO_BUTTON_VARIANT: Record<SurfaceVariant, ButtonVariant>;
286
291
  * not enumerate the others. Same list, nine names: the day `SURFACE_VARIANTS`
287
292
  * gains a member, eight of them keep working only by luck.
288
293
  */
289
- declare const PLAIN_SURFACE_VARIANTS: readonly ["elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass", "plain"];
294
+ declare const PLAIN_SURFACE_VARIANTS: readonly ["none", "elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass", "plain"];
290
295
  type PlainSurfaceVariant = (typeof PLAIN_SURFACE_VARIANTS)[number];
291
296
  type SurfaceTextTokens = {
292
297
  /** Section and card headings. */
@@ -317,7 +322,7 @@ type SurfaceTriggerTokens = {
317
322
  /** Complete focus indicator: outline reset, width, inset, colour. */
318
323
  focusRing: string;
319
324
  };
320
- declare const getSurfaceTriggerTokens: (color: TrueColor) => SurfaceTriggerTokens;
325
+ declare const getSurfaceTriggerTokens: (color: SurfaceTone) => SurfaceTriggerTokens;
321
326
  /**
322
327
  * The `CollapsibleHelpText` trigger — the shared surface-trigger tokens plus
323
328
  * the accent glyph, icon chip and title line.
@@ -400,7 +405,7 @@ declare const SURFACE_VARIANT_FOR_FIELD: Record<InputVariant, SurfaceVariant>;
400
405
  declare const isGlassSurface: (variant: PlainSurfaceVariant) => boolean;
401
406
  /** The panel tone that follows a field: the field keeps its accent as the
402
407
  * selected-day tint either way, so the fill takes the neutral default. */
403
- declare const PANEL_TONE_FOR_FIELD: "neutral";
408
+ declare const PANEL_TONE_FOR_FIELD: SurfaceTone;
404
409
  /**
405
410
  * The field surface a container implies — the reverse pairing: composite
406
411
  * controls whose rows of inputs sit *inside* a card (the `KeyValueArrayField`)
@@ -415,7 +420,7 @@ declare const INPUT_VARIANT_FOR_SURFACE: Record<PlainSurfaceVariant, InputVarian
415
420
  * component — `Panel` and its wrappers — resolves to this same constant, so a
416
421
  * default cannot be restated wrongly in one of them.
417
422
  */
418
- declare const DEFAULT_SURFACE_TONE: TrueColor;
423
+ declare const DEFAULT_SURFACE_TONE: SurfaceTone;
419
424
  /**
420
425
  * The `EmptyState` size for a pane that has its own header — a `Panel`
421
426
  * sibling like `PagedPanel` or `TagPanel`. `EmptyState`'s own scale is tuned
@@ -1029,9 +1034,9 @@ interface SurfaceVariantOverrides {
1029
1034
  /** Extra classes folded in for `liquid-glass` (vibrancy, glass fill). */
1030
1035
  liquidExtras?: string;
1031
1036
  }
1032
- declare const getPanelToneStyles: (tone: TrueColor) => PanelToneConfig;
1037
+ declare const getPanelToneStyles: (tone?: SurfaceTone) => PanelToneConfig;
1033
1038
  /** Shared surface paint, including the four-level background transparency scale. */
1034
- declare const getSurfaceVariantClasses: (variant: SurfaceVariant, tone: TrueColor, overrides?: SurfaceVariantOverrides) => string;
1039
+ declare const getSurfaceVariantClasses: (variant: SurfaceVariant, tone: SurfaceTone, overrides?: SurfaceVariantOverrides) => string;
1035
1040
  declare const getStepperTonePalette: (tone: TrueColor) => StepperToneConfig;
1036
1041
  declare const getBadgeColorClasses: (color: TrueColor) => string;
1037
1042
  declare const getPillColorClasses: (color: TrueColor, variant: "solid" | "soft" | "outline") => {
@@ -1232,6 +1237,8 @@ interface HelpButtonProps {
1232
1237
  placement?: HelpButtonPlacement;
1233
1238
  /** Accent color for the trigger button and the panel header band. @default "sky" */
1234
1239
  color?: TrueColor;
1240
+ /** Container tint; omitted means no tint. @default "none" */
1241
+ tone?: SurfaceTone;
1235
1242
  /**
1236
1243
  * Surface treatment of the floating panel — the shared container family the
1237
1244
  * `Panel` reference owns, so a help panel and a card beside it read the same.
@@ -1282,4 +1289,31 @@ interface CapsuleBlueprintParameter {
1282
1289
  [key: string]: any;
1283
1290
  }
1284
1291
 
1285
- export { type ControlSizeTokens as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, API_ERROR_KINDS as D, API_ERROR_KIND_CONFIG as E, type AlertIntentConfig as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type AlertVariantTokens as J, type ApiErrorKindConfig as K, BUTTON_VARIANTS as L, BUTTON_WEIGHTS as M, type BreadcrumbSizeTokens as N, type Orientation as O, type PlainSurfaceVariant as P, type BreadcrumbToneTokens as Q, CASCADE_EXPAND as R, type SurfaceCorner as S, type TrueColor as T, COLLAPSED_RAIL_WIDTH as U, type ValidationStatus as V, CONTROL_SIZES as W, CapsuleBlueprintValueType as X, type CheckboxControlTokens as Y, type CheckboxVariantTokens as Z, type CollapsibleHelpToneTokens as _, type AlertVariant as a, THIN_SCROLLBAR_FIELD as a$, DEFAULT_COMPACT_SURFACE_PADDING as a0, DEFAULT_CONTROL_CORNER as a1, DEFAULT_GLOW_INTENSITY as a2, DEFAULT_SURFACE_CORNER as a3, DEFAULT_SURFACE_GUTTER as a4, DEFAULT_SURFACE_PADDING as a5, DEFAULT_SURFACE_TONE as a6, DEFAULT_TOAST_GAP_PX as a7, DEFAULT_TOAST_LIFE_MS as a8, DEFAULT_TOAST_LIMIT as a9, SIDEBAR_IDLE_COPY as aA, SIDEBAR_MOBILE_QUERY as aB, SIDEBAR_SIDES as aC, SIDEBAR_VARIANTS as aD, SIDE_MENU_HEADER_FILL as aE, SIDE_MENU_HEADER_HEIGHT as aF, SIDE_MENU_HEADER_SEAM as aG, SLIDER_VARIANTS as aH, SURFACE_CORNERS as aI, SURFACE_GLASS_RIM as aJ, SURFACE_GUTTER_AXES as aK, SURFACE_PADDINGS as aL, SURFACE_TO_BUTTON_VARIANT as aM, SURFACE_TRANSPARENCIES as aN, SURFACE_VARIANT_BASE as aO, SURFACE_VARIANT_FOR_FIELD as aP, type SideMenuItemTokens as aQ, type SidebarIdleCopyKind as aR, type SidebarSurfaceTokens as aS, type SliderVariantTokens as aT, type StatusSpinnerSizeTokens as aU, type StatusSpinnerToneTokens as aV, type SurfaceGutterAxis as aW, type SurfaceTriggerTokens as aX, type SurfaceVariantOverrides as aY, TABLE_DENSITIES as aZ, THIN_SCROLLBAR as a_, DEFAULT_TOAST_MODE as aa, DEFAULT_TOAST_POSITION as ab, DEFAULT_TOAST_Z_INDEX as ac, DEFAULT_TRIGGER_CORNER as ad, FIELD_SIZE_STYLES as ae, FIELD_STATUS_CLASSES as af, type FieldSizeTokens as ag, type FieldToneTokens as ah, GLOW_INTENSITIES as ai, type GlowTokens as aj, HelpButton as ak, type HelpButtonPlacement as al, INPUT_VARIANTS as am, INPUT_VARIANT_FOR_SURFACE as an, type InputVariantOptions as ao, type InputVariantTokens as ap, SURFACE_VARIANTS as aq, NEUTRAL_TONES as ar, ORIENTATIONS as as, PANEL_SLIDE_DURATION_MS as at, PANEL_SLIDE_EASING as au, PANEL_TONE_FOR_FIELD as av, PANE_EMPTY_STATE_SIZE as aw, PLAIN_SURFACE_VARIANTS as ax, type ProgressSpinnerToneTokens as ay, SIDEBAR_COLLAPSIBLE_MODES as az, type AlertIconAlign as b, getToggleVariantTokens as b$, TOAST_DEFAULT_WIDTH as b0, TOAST_MODES as b1, TOAST_POSITIONS as b2, TOGGLE_VARIANTS as b3, TRANSLUCENT_SURFACE_VARIANTS as b4, TRUE_COLORS as b5, TRUE_COLOR_DOT_CLASSES as b6, TRUE_COLOR_TEXT_CLASSES as b7, type TableDensityTokens as b8, type ToastSizeTokens as b9, getLoaderProgressColors as bA, getMultiToggleColorTokens as bB, getMultiToggleVariantTokens as bC, getPanelToneStyles as bD, getPillColorClasses as bE, getProgressSpinnerToneTokens as bF, getSideMenuItemTokens as bG, getSidebarSurfaceTokens as bH, getSliderVariantTokens as bI, getSpinnerColorTokens as bJ, getStatTileColorClasses as bK, getStatusSpinnerSizeTokens as bL, getStatusSpinnerToneTokens as bM, getStepperTonePalette as bN, getSurfaceCornerClass as bO, getSurfaceCornerRem as bP, getSurfaceGutterClass as bQ, getSurfacePaddingClass as bR, getSurfacePaddingClasses as bS, getSurfaceTextTokens as bT, getSurfaceTransparencyClasses as bU, getSurfaceTriggerTokens as bV, getSurfaceVariantClasses as bW, getTableDensityTokens as bX, getTabsColorTokens as bY, getToastSizeTokens as bZ, getToggleColorClasses as b_, type ToggleVariantTokens as ba, VALIDATION_STATUSES as bb, configureTheme as bc, getAlertColorClasses as bd, getAlertVariantTokens as be, getAppDividerToneTokens as bf, getBadgeColorClasses as bg, getBreadcrumbSizeTokens as bh, getBreadcrumbToneTokens as bi, getButtonActiveClasses as bj, getButtonActiveHoverClasses as bk, getButtonBaseClasses as bl, getButtonColorClasses as bm, getButtonHoverClasses as bn, getCheckboxColorClasses as bo, getCheckboxControlTokens as bp, getCheckboxGlassCheckedTokens as bq, getCheckboxVariantTokens as br, getCollapsibleHelpToneTokens as bs, getCompactSurfacePaddingClass as bt, getCompactSurfacePaddingClasses as bu, getControlSizeTokens as bv, getFieldSizeTokens as bw, getFieldToneTokens as bx, getGlowTokens as by, getInputVariantTokens as bz, type GlassVibrancy as c, getTrueColorDotClass as c0, getTrueColorTextClass as c1, hasTextColor as c2, iconRegistry as c3, isGlassSurface as c4, panelSlideTransition as c5, resetTheme as c6, resolveGlowGradient as c7, resolveSurfaceTransparency as c8, stripBorderColor as c9, stripFillClass as ca, stripTextColor as cb, type SpecularMode as d, type ButtonWeight as e, type SurfaceVariant as f, type SurfaceTransparency as g, type SurfacePadding as h, type GlowIntensity as i, type InputVariant as j, type SliderVariant as k, type ToggleVariant as l, type ToastPosition as m, type ToastMode as n, type Size as o, type SidebarSide as p, type SidebarVariant as q, type SidebarCollapsible as r, type SurfaceTextTokens as s, type TableDensity as t, type ApiErrorKind as u, type CapsuleBlueprintParameter as v, ALERT_ICON_ALIGNMENTS as w, ALERT_INTENTS as x, ALERT_INTENT_CONFIG as y, ALERT_VARIANTS as z };
1292
+ interface CodeBlockProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange" | "color" | "children"> {
1293
+ /** Source is displayed and copied verbatim. */
1294
+ value: string;
1295
+ onChange?: (value: string) => void;
1296
+ /** Set false to show a native, controlled textarea. @default true */
1297
+ readOnly?: boolean;
1298
+ language?: string;
1299
+ filename?: string;
1300
+ /** Hide the header label and divider while keeping the copy action. @default true */
1301
+ showTitle?: boolean;
1302
+ /** @default true */
1303
+ showCopy?: boolean;
1304
+ /** Decorative line numbers in display mode. @default false */
1305
+ showLineNumbers?: boolean;
1306
+ /** @default false */
1307
+ wrapLines?: boolean;
1308
+ maxHeight?: number | string;
1309
+ color?: TrueColor;
1310
+ /** Container tint; omitted means no tint. @default "none" */
1311
+ tone?: SurfaceTone;
1312
+ variant?: SurfaceVariant;
1313
+ corner?: SurfaceCorner;
1314
+ editorLabel?: string;
1315
+ }
1316
+ /** Lightweight source display with optional native editing. */
1317
+ declare function CodeBlock({ value, onChange, readOnly, language, filename, showTitle, showCopy, showLineNumbers, wrapLines, maxHeight, tone, color, variant, corner, editorLabel, className, ...rest }: CodeBlockProps): React__default.JSX.Element;
1318
+
1319
+ export { CodeBlock as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, ALERT_VARIANTS as D, API_ERROR_KINDS as E, API_ERROR_KIND_CONFIG as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type AlertIntentConfig as J, type AlertVariantTokens as K, type ApiErrorKindConfig as L, BUTTON_VARIANTS as M, BUTTON_WEIGHTS as N, type Orientation as O, type PlainSurfaceVariant as P, type BreadcrumbSizeTokens as Q, type BreadcrumbToneTokens as R, type SurfaceCorner as S, type TrueColor as T, CASCADE_EXPAND as U, type ValidationStatus as V, COLLAPSED_RAIL_WIDTH as W, CONTROL_SIZES as X, CapsuleBlueprintValueType as Y, type CheckboxControlTokens as Z, type CheckboxVariantTokens as _, type AlertVariant as a, type SurfaceTriggerTokens as a$, type CodeBlockProps as a0, type CollapsibleHelpToneTokens as a1, type ControlSizeTokens as a2, DEFAULT_COMPACT_SURFACE_PADDING as a3, DEFAULT_CONTROL_CORNER as a4, DEFAULT_GLOW_INTENSITY as a5, DEFAULT_SURFACE_CORNER as a6, DEFAULT_SURFACE_GUTTER as a7, DEFAULT_SURFACE_PADDING as a8, DEFAULT_SURFACE_TONE as a9, PLAIN_SURFACE_VARIANTS as aA, type ProgressSpinnerToneTokens as aB, SIDEBAR_COLLAPSIBLE_MODES as aC, SIDEBAR_IDLE_COPY as aD, SIDEBAR_MOBILE_QUERY as aE, SIDEBAR_SIDES as aF, SIDEBAR_VARIANTS as aG, SIDE_MENU_HEADER_FILL as aH, SIDE_MENU_HEADER_HEIGHT as aI, SIDE_MENU_HEADER_SEAM as aJ, SLIDER_VARIANTS as aK, SURFACE_CORNERS as aL, SURFACE_GLASS_RIM as aM, SURFACE_GUTTER_AXES as aN, SURFACE_PADDINGS as aO, SURFACE_TONES as aP, SURFACE_TO_BUTTON_VARIANT as aQ, SURFACE_TRANSPARENCIES as aR, SURFACE_VARIANT_BASE as aS, SURFACE_VARIANT_FOR_FIELD as aT, type SideMenuItemTokens as aU, type SidebarIdleCopyKind as aV, type SidebarSurfaceTokens as aW, type SliderVariantTokens as aX, type StatusSpinnerSizeTokens as aY, type StatusSpinnerToneTokens as aZ, type SurfaceGutterAxis as a_, DEFAULT_TOAST_GAP_PX as aa, DEFAULT_TOAST_LIFE_MS as ab, DEFAULT_TOAST_LIMIT as ac, DEFAULT_TOAST_MODE as ad, DEFAULT_TOAST_POSITION as ae, DEFAULT_TOAST_Z_INDEX as af, DEFAULT_TRIGGER_CORNER as ag, FIELD_SIZE_STYLES as ah, FIELD_STATUS_CLASSES as ai, type FieldSizeTokens as aj, type FieldToneTokens as ak, GLOW_INTENSITIES as al, type GlowTokens as am, HelpButton as an, type HelpButtonPlacement as ao, INPUT_VARIANTS as ap, INPUT_VARIANT_FOR_SURFACE as aq, type InputVariantOptions as ar, type InputVariantTokens as as, SURFACE_VARIANTS as at, NEUTRAL_TONES as au, ORIENTATIONS as av, PANEL_SLIDE_DURATION_MS as aw, PANEL_SLIDE_EASING as ax, PANEL_TONE_FOR_FIELD as ay, PANE_EMPTY_STATE_SIZE as az, type AlertIconAlign as b, getSurfaceVariantClasses as b$, type SurfaceVariantOverrides as b0, TABLE_DENSITIES as b1, THIN_SCROLLBAR as b2, THIN_SCROLLBAR_FIELD as b3, TOAST_DEFAULT_WIDTH as b4, TOAST_MODES as b5, TOAST_POSITIONS as b6, TOGGLE_VARIANTS as b7, TRANSLUCENT_SURFACE_VARIANTS as b8, TRUE_COLORS as b9, getFieldSizeTokens as bA, getFieldToneTokens as bB, getGlowTokens as bC, getInputVariantTokens as bD, getLoaderProgressColors as bE, getMultiToggleColorTokens as bF, getMultiToggleVariantTokens as bG, getPanelToneStyles as bH, getPillColorClasses as bI, getProgressSpinnerToneTokens as bJ, getSideMenuItemTokens as bK, getSidebarSurfaceTokens as bL, getSliderVariantTokens as bM, getSpinnerColorTokens as bN, getStatTileColorClasses as bO, getStatusSpinnerSizeTokens as bP, getStatusSpinnerToneTokens as bQ, getStepperTonePalette as bR, getSurfaceAccentColor as bS, getSurfaceCornerClass as bT, getSurfaceCornerRem as bU, getSurfaceGutterClass as bV, getSurfacePaddingClass as bW, getSurfacePaddingClasses as bX, getSurfaceTextTokens as bY, getSurfaceTransparencyClasses as bZ, getSurfaceTriggerTokens as b_, TRUE_COLOR_DOT_CLASSES as ba, TRUE_COLOR_TEXT_CLASSES as bb, type TableDensityTokens as bc, type ToastSizeTokens as bd, type ToggleVariantTokens as be, VALIDATION_STATUSES as bf, configureTheme as bg, getAlertColorClasses as bh, getAlertVariantTokens as bi, getAppDividerToneTokens as bj, getBadgeColorClasses as bk, getBreadcrumbSizeTokens as bl, getBreadcrumbToneTokens as bm, getButtonActiveClasses as bn, getButtonActiveHoverClasses as bo, getButtonBaseClasses as bp, getButtonColorClasses as bq, getButtonHoverClasses as br, getCheckboxColorClasses as bs, getCheckboxControlTokens as bt, getCheckboxGlassCheckedTokens as bu, getCheckboxVariantTokens as bv, getCollapsibleHelpToneTokens as bw, getCompactSurfacePaddingClass as bx, getCompactSurfacePaddingClasses as by, getControlSizeTokens as bz, type GlassVibrancy as c, getTableDensityTokens as c0, getTabsColorTokens as c1, getToastSizeTokens as c2, getToggleColorClasses as c3, getToggleVariantTokens as c4, getTrueColorDotClass as c5, getTrueColorTextClass as c6, hasTextColor as c7, iconRegistry as c8, isGlassSurface as c9, panelSlideTransition as ca, resetTheme as cb, resolveGlowGradient as cc, resolveSurfaceTransparency as cd, stripBorderColor as ce, stripFillClass as cf, stripTextColor as cg, type SpecularMode as d, type ButtonWeight as e, type SurfaceTone as f, type SurfaceVariant as g, type SurfaceTransparency as h, type SurfacePadding as i, type GlowIntensity as j, type InputVariant as k, type SliderVariant as l, type ToggleVariant as m, type ToastPosition as n, type ToastMode as o, type Size as p, type SidebarSide as q, type SidebarVariant as r, type SidebarCollapsible as s, type SurfaceTextTokens as t, type TableDensity as u, type ApiErrorKind as v, type CapsuleBlueprintParameter as w, ALERT_ICON_ALIGNMENTS as x, ALERT_INTENTS as y, ALERT_INTENT_CONFIG as z };
@@ -69,6 +69,11 @@ declare const TRUE_COLORS: readonly ["red", "orange", "amber", "yellow", "lime",
69
69
  * All components, tokens, and utilities must use TrueColor exclusively.
70
70
  */
71
71
  type TrueColor = (typeof TRUE_COLORS)[number];
72
+ /** Container tint is independent of control/status accent colors. */
73
+ type SurfaceTone = TrueColor | "none";
74
+ declare const SURFACE_TONES: readonly ["none", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "rose", "slate", "gray", "zinc", "neutral", "stone"];
75
+ /** A non-tinted surface still needs a real color for controls and focus cues. */
76
+ declare const getSurfaceAccentColor: (tone: SurfaceTone) => TrueColor;
72
77
  /**
73
78
  * The fill class for a dot/swatch of each TrueColor: the 500 step in light
74
79
  * mode, the 400 step in dark. Literal per colour — never interpolated — so
@@ -269,7 +274,7 @@ declare const FIELD_STATUS_CLASSES: Record<"error" | "success", string>;
269
274
  * (`FormSection`). Kept here so the type and the text that sits on those
270
275
  * surfaces are defined once, not per component.
271
276
  */
272
- declare const SURFACE_VARIANTS: readonly ["elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass"];
277
+ declare const SURFACE_VARIANTS: readonly ["none", "elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass"];
273
278
  type SurfaceVariant = (typeof SURFACE_VARIANTS)[number];
274
279
  /**
275
280
  * The button a card surface implies — what a card CTA wears when it is not
@@ -286,7 +291,7 @@ declare const SURFACE_TO_BUTTON_VARIANT: Record<SurfaceVariant, ButtonVariant>;
286
291
  * not enumerate the others. Same list, nine names: the day `SURFACE_VARIANTS`
287
292
  * gains a member, eight of them keep working only by luck.
288
293
  */
289
- declare const PLAIN_SURFACE_VARIANTS: readonly ["elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass", "plain"];
294
+ declare const PLAIN_SURFACE_VARIANTS: readonly ["none", "elevated", "outlined", "subtle", "tonal", "default", "glass", "simple", "liquid-glass", "plain"];
290
295
  type PlainSurfaceVariant = (typeof PLAIN_SURFACE_VARIANTS)[number];
291
296
  type SurfaceTextTokens = {
292
297
  /** Section and card headings. */
@@ -317,7 +322,7 @@ type SurfaceTriggerTokens = {
317
322
  /** Complete focus indicator: outline reset, width, inset, colour. */
318
323
  focusRing: string;
319
324
  };
320
- declare const getSurfaceTriggerTokens: (color: TrueColor) => SurfaceTriggerTokens;
325
+ declare const getSurfaceTriggerTokens: (color: SurfaceTone) => SurfaceTriggerTokens;
321
326
  /**
322
327
  * The `CollapsibleHelpText` trigger — the shared surface-trigger tokens plus
323
328
  * the accent glyph, icon chip and title line.
@@ -400,7 +405,7 @@ declare const SURFACE_VARIANT_FOR_FIELD: Record<InputVariant, SurfaceVariant>;
400
405
  declare const isGlassSurface: (variant: PlainSurfaceVariant) => boolean;
401
406
  /** The panel tone that follows a field: the field keeps its accent as the
402
407
  * selected-day tint either way, so the fill takes the neutral default. */
403
- declare const PANEL_TONE_FOR_FIELD: "neutral";
408
+ declare const PANEL_TONE_FOR_FIELD: SurfaceTone;
404
409
  /**
405
410
  * The field surface a container implies — the reverse pairing: composite
406
411
  * controls whose rows of inputs sit *inside* a card (the `KeyValueArrayField`)
@@ -415,7 +420,7 @@ declare const INPUT_VARIANT_FOR_SURFACE: Record<PlainSurfaceVariant, InputVarian
415
420
  * component — `Panel` and its wrappers — resolves to this same constant, so a
416
421
  * default cannot be restated wrongly in one of them.
417
422
  */
418
- declare const DEFAULT_SURFACE_TONE: TrueColor;
423
+ declare const DEFAULT_SURFACE_TONE: SurfaceTone;
419
424
  /**
420
425
  * The `EmptyState` size for a pane that has its own header — a `Panel`
421
426
  * sibling like `PagedPanel` or `TagPanel`. `EmptyState`'s own scale is tuned
@@ -1029,9 +1034,9 @@ interface SurfaceVariantOverrides {
1029
1034
  /** Extra classes folded in for `liquid-glass` (vibrancy, glass fill). */
1030
1035
  liquidExtras?: string;
1031
1036
  }
1032
- declare const getPanelToneStyles: (tone: TrueColor) => PanelToneConfig;
1037
+ declare const getPanelToneStyles: (tone?: SurfaceTone) => PanelToneConfig;
1033
1038
  /** Shared surface paint, including the four-level background transparency scale. */
1034
- declare const getSurfaceVariantClasses: (variant: SurfaceVariant, tone: TrueColor, overrides?: SurfaceVariantOverrides) => string;
1039
+ declare const getSurfaceVariantClasses: (variant: SurfaceVariant, tone: SurfaceTone, overrides?: SurfaceVariantOverrides) => string;
1035
1040
  declare const getStepperTonePalette: (tone: TrueColor) => StepperToneConfig;
1036
1041
  declare const getBadgeColorClasses: (color: TrueColor) => string;
1037
1042
  declare const getPillColorClasses: (color: TrueColor, variant: "solid" | "soft" | "outline") => {
@@ -1232,6 +1237,8 @@ interface HelpButtonProps {
1232
1237
  placement?: HelpButtonPlacement;
1233
1238
  /** Accent color for the trigger button and the panel header band. @default "sky" */
1234
1239
  color?: TrueColor;
1240
+ /** Container tint; omitted means no tint. @default "none" */
1241
+ tone?: SurfaceTone;
1235
1242
  /**
1236
1243
  * Surface treatment of the floating panel — the shared container family the
1237
1244
  * `Panel` reference owns, so a help panel and a card beside it read the same.
@@ -1282,4 +1289,31 @@ interface CapsuleBlueprintParameter {
1282
1289
  [key: string]: any;
1283
1290
  }
1284
1291
 
1285
- export { type ControlSizeTokens as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, API_ERROR_KINDS as D, API_ERROR_KIND_CONFIG as E, type AlertIntentConfig as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type AlertVariantTokens as J, type ApiErrorKindConfig as K, BUTTON_VARIANTS as L, BUTTON_WEIGHTS as M, type BreadcrumbSizeTokens as N, type Orientation as O, type PlainSurfaceVariant as P, type BreadcrumbToneTokens as Q, CASCADE_EXPAND as R, type SurfaceCorner as S, type TrueColor as T, COLLAPSED_RAIL_WIDTH as U, type ValidationStatus as V, CONTROL_SIZES as W, CapsuleBlueprintValueType as X, type CheckboxControlTokens as Y, type CheckboxVariantTokens as Z, type CollapsibleHelpToneTokens as _, type AlertVariant as a, THIN_SCROLLBAR_FIELD as a$, DEFAULT_COMPACT_SURFACE_PADDING as a0, DEFAULT_CONTROL_CORNER as a1, DEFAULT_GLOW_INTENSITY as a2, DEFAULT_SURFACE_CORNER as a3, DEFAULT_SURFACE_GUTTER as a4, DEFAULT_SURFACE_PADDING as a5, DEFAULT_SURFACE_TONE as a6, DEFAULT_TOAST_GAP_PX as a7, DEFAULT_TOAST_LIFE_MS as a8, DEFAULT_TOAST_LIMIT as a9, SIDEBAR_IDLE_COPY as aA, SIDEBAR_MOBILE_QUERY as aB, SIDEBAR_SIDES as aC, SIDEBAR_VARIANTS as aD, SIDE_MENU_HEADER_FILL as aE, SIDE_MENU_HEADER_HEIGHT as aF, SIDE_MENU_HEADER_SEAM as aG, SLIDER_VARIANTS as aH, SURFACE_CORNERS as aI, SURFACE_GLASS_RIM as aJ, SURFACE_GUTTER_AXES as aK, SURFACE_PADDINGS as aL, SURFACE_TO_BUTTON_VARIANT as aM, SURFACE_TRANSPARENCIES as aN, SURFACE_VARIANT_BASE as aO, SURFACE_VARIANT_FOR_FIELD as aP, type SideMenuItemTokens as aQ, type SidebarIdleCopyKind as aR, type SidebarSurfaceTokens as aS, type SliderVariantTokens as aT, type StatusSpinnerSizeTokens as aU, type StatusSpinnerToneTokens as aV, type SurfaceGutterAxis as aW, type SurfaceTriggerTokens as aX, type SurfaceVariantOverrides as aY, TABLE_DENSITIES as aZ, THIN_SCROLLBAR as a_, DEFAULT_TOAST_MODE as aa, DEFAULT_TOAST_POSITION as ab, DEFAULT_TOAST_Z_INDEX as ac, DEFAULT_TRIGGER_CORNER as ad, FIELD_SIZE_STYLES as ae, FIELD_STATUS_CLASSES as af, type FieldSizeTokens as ag, type FieldToneTokens as ah, GLOW_INTENSITIES as ai, type GlowTokens as aj, HelpButton as ak, type HelpButtonPlacement as al, INPUT_VARIANTS as am, INPUT_VARIANT_FOR_SURFACE as an, type InputVariantOptions as ao, type InputVariantTokens as ap, SURFACE_VARIANTS as aq, NEUTRAL_TONES as ar, ORIENTATIONS as as, PANEL_SLIDE_DURATION_MS as at, PANEL_SLIDE_EASING as au, PANEL_TONE_FOR_FIELD as av, PANE_EMPTY_STATE_SIZE as aw, PLAIN_SURFACE_VARIANTS as ax, type ProgressSpinnerToneTokens as ay, SIDEBAR_COLLAPSIBLE_MODES as az, type AlertIconAlign as b, getToggleVariantTokens as b$, TOAST_DEFAULT_WIDTH as b0, TOAST_MODES as b1, TOAST_POSITIONS as b2, TOGGLE_VARIANTS as b3, TRANSLUCENT_SURFACE_VARIANTS as b4, TRUE_COLORS as b5, TRUE_COLOR_DOT_CLASSES as b6, TRUE_COLOR_TEXT_CLASSES as b7, type TableDensityTokens as b8, type ToastSizeTokens as b9, getLoaderProgressColors as bA, getMultiToggleColorTokens as bB, getMultiToggleVariantTokens as bC, getPanelToneStyles as bD, getPillColorClasses as bE, getProgressSpinnerToneTokens as bF, getSideMenuItemTokens as bG, getSidebarSurfaceTokens as bH, getSliderVariantTokens as bI, getSpinnerColorTokens as bJ, getStatTileColorClasses as bK, getStatusSpinnerSizeTokens as bL, getStatusSpinnerToneTokens as bM, getStepperTonePalette as bN, getSurfaceCornerClass as bO, getSurfaceCornerRem as bP, getSurfaceGutterClass as bQ, getSurfacePaddingClass as bR, getSurfacePaddingClasses as bS, getSurfaceTextTokens as bT, getSurfaceTransparencyClasses as bU, getSurfaceTriggerTokens as bV, getSurfaceVariantClasses as bW, getTableDensityTokens as bX, getTabsColorTokens as bY, getToastSizeTokens as bZ, getToggleColorClasses as b_, type ToggleVariantTokens as ba, VALIDATION_STATUSES as bb, configureTheme as bc, getAlertColorClasses as bd, getAlertVariantTokens as be, getAppDividerToneTokens as bf, getBadgeColorClasses as bg, getBreadcrumbSizeTokens as bh, getBreadcrumbToneTokens as bi, getButtonActiveClasses as bj, getButtonActiveHoverClasses as bk, getButtonBaseClasses as bl, getButtonColorClasses as bm, getButtonHoverClasses as bn, getCheckboxColorClasses as bo, getCheckboxControlTokens as bp, getCheckboxGlassCheckedTokens as bq, getCheckboxVariantTokens as br, getCollapsibleHelpToneTokens as bs, getCompactSurfacePaddingClass as bt, getCompactSurfacePaddingClasses as bu, getControlSizeTokens as bv, getFieldSizeTokens as bw, getFieldToneTokens as bx, getGlowTokens as by, getInputVariantTokens as bz, type GlassVibrancy as c, getTrueColorDotClass as c0, getTrueColorTextClass as c1, hasTextColor as c2, iconRegistry as c3, isGlassSurface as c4, panelSlideTransition as c5, resetTheme as c6, resolveGlowGradient as c7, resolveSurfaceTransparency as c8, stripBorderColor as c9, stripFillClass as ca, stripTextColor as cb, type SpecularMode as d, type ButtonWeight as e, type SurfaceVariant as f, type SurfaceTransparency as g, type SurfacePadding as h, type GlowIntensity as i, type InputVariant as j, type SliderVariant as k, type ToggleVariant as l, type ToastPosition as m, type ToastMode as n, type Size as o, type SidebarSide as p, type SidebarVariant as q, type SidebarCollapsible as r, type SurfaceTextTokens as s, type TableDensity as t, type ApiErrorKind as u, type CapsuleBlueprintParameter as v, ALERT_ICON_ALIGNMENTS as w, ALERT_INTENTS as x, ALERT_INTENT_CONFIG as y, ALERT_VARIANTS as z };
1292
+ interface CodeBlockProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, "onChange" | "color" | "children"> {
1293
+ /** Source is displayed and copied verbatim. */
1294
+ value: string;
1295
+ onChange?: (value: string) => void;
1296
+ /** Set false to show a native, controlled textarea. @default true */
1297
+ readOnly?: boolean;
1298
+ language?: string;
1299
+ filename?: string;
1300
+ /** Hide the header label and divider while keeping the copy action. @default true */
1301
+ showTitle?: boolean;
1302
+ /** @default true */
1303
+ showCopy?: boolean;
1304
+ /** Decorative line numbers in display mode. @default false */
1305
+ showLineNumbers?: boolean;
1306
+ /** @default false */
1307
+ wrapLines?: boolean;
1308
+ maxHeight?: number | string;
1309
+ color?: TrueColor;
1310
+ /** Container tint; omitted means no tint. @default "none" */
1311
+ tone?: SurfaceTone;
1312
+ variant?: SurfaceVariant;
1313
+ corner?: SurfaceCorner;
1314
+ editorLabel?: string;
1315
+ }
1316
+ /** Lightweight source display with optional native editing. */
1317
+ declare function CodeBlock({ value, onChange, readOnly, language, filename, showTitle, showCopy, showLineNumbers, wrapLines, maxHeight, tone, color, variant, corner, editorLabel, className, ...rest }: CodeBlockProps): React__default.JSX.Element;
1318
+
1319
+ export { CodeBlock as $, type AlertIntent as A, type ButtonVariant as B, type ControlSize as C, ALERT_VARIANTS as D, API_ERROR_KINDS as E, API_ERROR_KIND_CONFIG as F, type GlassOpacity as G, type HelpButtonProps as H, type IconName as I, type AlertIntentConfig as J, type AlertVariantTokens as K, type ApiErrorKindConfig as L, BUTTON_VARIANTS as M, BUTTON_WEIGHTS as N, type Orientation as O, type PlainSurfaceVariant as P, type BreadcrumbSizeTokens as Q, type BreadcrumbToneTokens as R, type SurfaceCorner as S, type TrueColor as T, CASCADE_EXPAND as U, type ValidationStatus as V, COLLAPSED_RAIL_WIDTH as W, CONTROL_SIZES as X, CapsuleBlueprintValueType as Y, type CheckboxControlTokens as Z, type CheckboxVariantTokens as _, type AlertVariant as a, type SurfaceTriggerTokens as a$, type CodeBlockProps as a0, type CollapsibleHelpToneTokens as a1, type ControlSizeTokens as a2, DEFAULT_COMPACT_SURFACE_PADDING as a3, DEFAULT_CONTROL_CORNER as a4, DEFAULT_GLOW_INTENSITY as a5, DEFAULT_SURFACE_CORNER as a6, DEFAULT_SURFACE_GUTTER as a7, DEFAULT_SURFACE_PADDING as a8, DEFAULT_SURFACE_TONE as a9, PLAIN_SURFACE_VARIANTS as aA, type ProgressSpinnerToneTokens as aB, SIDEBAR_COLLAPSIBLE_MODES as aC, SIDEBAR_IDLE_COPY as aD, SIDEBAR_MOBILE_QUERY as aE, SIDEBAR_SIDES as aF, SIDEBAR_VARIANTS as aG, SIDE_MENU_HEADER_FILL as aH, SIDE_MENU_HEADER_HEIGHT as aI, SIDE_MENU_HEADER_SEAM as aJ, SLIDER_VARIANTS as aK, SURFACE_CORNERS as aL, SURFACE_GLASS_RIM as aM, SURFACE_GUTTER_AXES as aN, SURFACE_PADDINGS as aO, SURFACE_TONES as aP, SURFACE_TO_BUTTON_VARIANT as aQ, SURFACE_TRANSPARENCIES as aR, SURFACE_VARIANT_BASE as aS, SURFACE_VARIANT_FOR_FIELD as aT, type SideMenuItemTokens as aU, type SidebarIdleCopyKind as aV, type SidebarSurfaceTokens as aW, type SliderVariantTokens as aX, type StatusSpinnerSizeTokens as aY, type StatusSpinnerToneTokens as aZ, type SurfaceGutterAxis as a_, DEFAULT_TOAST_GAP_PX as aa, DEFAULT_TOAST_LIFE_MS as ab, DEFAULT_TOAST_LIMIT as ac, DEFAULT_TOAST_MODE as ad, DEFAULT_TOAST_POSITION as ae, DEFAULT_TOAST_Z_INDEX as af, DEFAULT_TRIGGER_CORNER as ag, FIELD_SIZE_STYLES as ah, FIELD_STATUS_CLASSES as ai, type FieldSizeTokens as aj, type FieldToneTokens as ak, GLOW_INTENSITIES as al, type GlowTokens as am, HelpButton as an, type HelpButtonPlacement as ao, INPUT_VARIANTS as ap, INPUT_VARIANT_FOR_SURFACE as aq, type InputVariantOptions as ar, type InputVariantTokens as as, SURFACE_VARIANTS as at, NEUTRAL_TONES as au, ORIENTATIONS as av, PANEL_SLIDE_DURATION_MS as aw, PANEL_SLIDE_EASING as ax, PANEL_TONE_FOR_FIELD as ay, PANE_EMPTY_STATE_SIZE as az, type AlertIconAlign as b, getSurfaceVariantClasses as b$, type SurfaceVariantOverrides as b0, TABLE_DENSITIES as b1, THIN_SCROLLBAR as b2, THIN_SCROLLBAR_FIELD as b3, TOAST_DEFAULT_WIDTH as b4, TOAST_MODES as b5, TOAST_POSITIONS as b6, TOGGLE_VARIANTS as b7, TRANSLUCENT_SURFACE_VARIANTS as b8, TRUE_COLORS as b9, getFieldSizeTokens as bA, getFieldToneTokens as bB, getGlowTokens as bC, getInputVariantTokens as bD, getLoaderProgressColors as bE, getMultiToggleColorTokens as bF, getMultiToggleVariantTokens as bG, getPanelToneStyles as bH, getPillColorClasses as bI, getProgressSpinnerToneTokens as bJ, getSideMenuItemTokens as bK, getSidebarSurfaceTokens as bL, getSliderVariantTokens as bM, getSpinnerColorTokens as bN, getStatTileColorClasses as bO, getStatusSpinnerSizeTokens as bP, getStatusSpinnerToneTokens as bQ, getStepperTonePalette as bR, getSurfaceAccentColor as bS, getSurfaceCornerClass as bT, getSurfaceCornerRem as bU, getSurfaceGutterClass as bV, getSurfacePaddingClass as bW, getSurfacePaddingClasses as bX, getSurfaceTextTokens as bY, getSurfaceTransparencyClasses as bZ, getSurfaceTriggerTokens as b_, TRUE_COLOR_DOT_CLASSES as ba, TRUE_COLOR_TEXT_CLASSES as bb, type TableDensityTokens as bc, type ToastSizeTokens as bd, type ToggleVariantTokens as be, VALIDATION_STATUSES as bf, configureTheme as bg, getAlertColorClasses as bh, getAlertVariantTokens as bi, getAppDividerToneTokens as bj, getBadgeColorClasses as bk, getBreadcrumbSizeTokens as bl, getBreadcrumbToneTokens as bm, getButtonActiveClasses as bn, getButtonActiveHoverClasses as bo, getButtonBaseClasses as bp, getButtonColorClasses as bq, getButtonHoverClasses as br, getCheckboxColorClasses as bs, getCheckboxControlTokens as bt, getCheckboxGlassCheckedTokens as bu, getCheckboxVariantTokens as bv, getCollapsibleHelpToneTokens as bw, getCompactSurfacePaddingClass as bx, getCompactSurfacePaddingClasses as by, getControlSizeTokens as bz, type GlassVibrancy as c, getTableDensityTokens as c0, getTabsColorTokens as c1, getToastSizeTokens as c2, getToggleColorClasses as c3, getToggleVariantTokens as c4, getTrueColorDotClass as c5, getTrueColorTextClass as c6, hasTextColor as c7, iconRegistry as c8, isGlassSurface as c9, panelSlideTransition as ca, resetTheme as cb, resolveGlowGradient as cc, resolveSurfaceTransparency as cd, stripBorderColor as ce, stripFillClass as cf, stripTextColor as cg, type SpecularMode as d, type ButtonWeight as e, type SurfaceTone as f, type SurfaceVariant as g, type SurfaceTransparency as h, type SurfacePadding as i, type GlowIntensity as j, type InputVariant as k, type SliderVariant as l, type ToggleVariant as m, type ToastPosition as n, type ToastMode as o, type Size as p, type SidebarSide as q, type SidebarVariant as r, type SidebarCollapsible as s, type SurfaceTextTokens as t, type TableDensity as u, type ApiErrorKind as v, type CapsuleBlueprintParameter as w, ALERT_ICON_ALIGNMENTS as x, ALERT_INTENTS as y, ALERT_INTENT_CONFIG as z };