@helixui/react 3.1.0 → 3.3.0

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.
@@ -29,7 +29,16 @@ export interface HxButtonProps {
29
29
  Sets the host to `display: block` and the inner element to `width: 100%`. */
30
30
  full?: boolean;
31
31
  /** When true, flips button colors for placement on dark or gradient backgrounds.
32
- Forces text to white and adjusts hover/focus ring colors across all variants. */
32
+ Forces text to white and adjusts hover/focus ring colors across all variants.
33
+
34
+ **Mode scope:** `[inverted]` is validated for placement on a dark *region*
35
+ within a light-mode-active page (hero banners, gradient sections, dark
36
+ cards). It is NOT validated for use within a dark-mode-active root
37
+ context: in dark mode, `surface.inverse` flips to a light surface
38
+ (neutral-100), and the lifted `-400` hover/active fills lose UI-floor
39
+ contrast against it (primary 2.10:1, danger 2.32:1 vs WCAG 1.4.11's 3:1
40
+ floor). Mode-aware fill stops + foreground for the dark-mode-inverted
41
+ combination are tracked as a 3.2.x follow-up. */
33
42
  inverted?: boolean;
34
43
  /** Accessible label for icon-only or text-less buttons.
35
44
  Required when the button has no visible text content.
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxButton/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChF,0BAA0B;IAC1B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;6DACyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sFAAsF;IACtF,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;8EAC0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;kFAC8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;2DAIuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,iFAAiF;IACjF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxButton/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAChF,0BAA0B;IAC1B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;6DACyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sFAAsF;IACtF,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;8EAC0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;;;kDAU8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;2DAIuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,iFAAiF;IACjF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC"}
@@ -19,7 +19,14 @@ export interface HxThemeProps {
19
19
 
20
20
  The brand must first be registered via `HelixBrandRegistry.register()`.
21
21
  If the brand name is non-empty but not registered, a warning is logged
22
- and the base theme is applied without brand overrides. */
22
+ and the base theme is applied without brand overrides.
23
+
24
+ **High-contrast suppression:** When `theme="high-contrast"`, the brand
25
+ merge is intentionally skipped to preserve the WCAG 1.4.6 Enhanced
26
+ Contrast (7:1+) guarantee that the HC token set is tuned for. A
27
+ registered brand applied under HC emits a `console.info` to surface
28
+ the suppression in development. Brand merging on `light` and `dark`
29
+ is unaffected. See `BRAND_THEMING.md`. */
23
30
  brand?: string;
24
31
  /** Controls motion behavior for all descendant `hx-*` components.
25
32
  - `"full"` (default): Full animations. Respects OS `prefers-reduced-motion`.
@@ -37,9 +44,9 @@ export interface HxThemeProps {
37
44
  - `"spacious"`: Increases `--hx-space-*` tokens ~25%. For touch-optimized bedside tablets. */
38
45
  density?: string;
39
46
  /** Returns the currently active theme name.
40
- When `system=true` or `theme="auto"`, reflects the OS preference (`"light"` or `"dark"`).
47
+ When `theme="auto"`, reflects the OS preference (`"light"` or `"dark"`).
41
48
  Otherwise returns the `theme` property value. */
42
- effectiveTheme?: 'light' | 'dark' | 'high-contrast' | 'auto';
49
+ effectiveTheme?: 'light' | 'dark' | 'high-contrast';
43
50
  /** Returns the resolved motion level after considering the `motion` attribute and OS preference.
44
51
  When `motion="full"` and the OS reports `prefers-reduced-motion: reduce`, returns `"reduced"`.
45
52
  Otherwise returns `"full"` or `"reduced"` based on the `motion` attribute. */
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTheme/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;;;gGAI4F;IAC5F,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;IACpD;;;;;;;2DAOuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;wDAQoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;+FAG2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;kDAE8C;IAC9C,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;IAC7D;;+EAE2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxTheme/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;;;gGAI4F;IAC5F,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;IACpD;;;;;;;;;;;;;;2CAcuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;wDAQoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;+FAG2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;kDAE8C;IAC9C,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,eAAe,CAAC;IACpD;;+EAE2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@helixui/react",
3
- "version": "3.1.0",
3
+ "version": "3.3.0",
4
4
  "description": "React wrappers for HELiX web components",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -24,7 +24,7 @@
24
24
  "dependencies": {
25
25
  "@lit/react": "^1.0.6",
26
26
  "react": "^18.3.1",
27
- "@helixui/library": "3.1.0"
27
+ "@helixui/library": "3.3.0"
28
28
  },
29
29
  "devDependencies": {
30
30
  "@types/react": "^18.3.18",