@helixui/react 3.8.0 → 3.9.0

package/dist/components/HxFileUpload/types.d.ts

@@ -21,6 +21,9 @@ export interface HxFileUploadProps {
     label?: string;
     /** Whether the component is disabled. */
     disabled?: boolean;
+    /** Whether the field must have at least one file selected for form submission.
+  Drives `validity.valueMissing` when the file list is empty. */
+    required?: boolean;
     /** Error message displayed below the dropzone. Also puts the dropzone in an error visual state. */
     error?: string;
     /** Instructional text shown in the dropzone when no custom slot content is provided.

package/dist/components/HxFileUpload/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxFileUpload/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,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,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;+DAC2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;wDACoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;2DAIuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAGf,uEAAuE;IACvE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxFileUpload/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,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,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;+DAC2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;gEAC4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;wDACoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;2DAIuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAGf,uEAAuE;IACvE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,qFAAqF;IACrF,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACrC"}

package/dist/components/HxIcon/HxIcon.d.ts

@@ -2,16 +2,29 @@ import { HelixIcon } from '@helixui/library/components/hx-icon';
 import { HxIconProps } from './types.js';
 export type { HxIconProps };
 /**
- * An icon component that supports inline SVG fetching and SVG sprite sheet references.
-Decorative icons are automatically hidden from assistive technology.
-When a label is provided the icon is announced as an image with that label.
+ * An icon component that resolves through the `@helixui/icons` registry,
+with sprite-sheet and inline-fetch escape hatches for legacy / consumer
+patterns. Decorative icons are automatically hidden from assistive
+technology. When a label is provided the icon is announced as an image
+with that label.
 
-**Render modes:**
-- **Sprite mode** (recommended for Drupal/SSR): Set `name` and optionally `sprite-url`.
-  Renders an `<svg><use href="...#name">` — works server-side without JavaScript.
-- **Inline mode**: Set `src` to a URL of a standalone SVG file. The component fetches,
-  sanitizes, and embeds the SVG markup. Requires JavaScript; not server-side renderable.
-  For Drupal/Twig templates use sprite mode to avoid content shift before hydration.
+**Render modes (in resolution order):**
+1. **Inline fetch (`src`)** — Set `src` to a URL of a standalone SVG file.
+   The component fetches, sanitizes, and embeds the SVG markup. Requires
+   JavaScript; not server-side renderable. Library attribute is ignored.
+2. **Explicit sprite (`sprite-url` + `name`)** — Pin the sprite URL on the
+   element instead of resolving through the registry. Library attribute is
+   ignored.
+3. **Registry (`library` + `name`)** (recommended) — Resolves through the
+   `@helixui/icons` registry. Set `library="fa-free"` for the FA Free Solid
+   set bundled with `@helixui/icons`, or `library="helix"` for the curated
+   32-glyph helix set. Consumer libraries register via `registerIconLibrary()`
+   and become resolvable here without modifying the component.
+4. **Bare name (`name` only, no `library`)** — `library` defaults to the
+   empty string. The component emits `<use href="#name">` against a
+   document-local sprite — pre-3.9.0 back-compat behavior. Consumers
+   opt INTO registry resolution by setting `library` explicitly.
+5. **No name / no src** — Renders nothing.
  *
  * @example
  * ```tsx

package/dist/components/HxIcon/HxIcon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HxIcon.d.ts","sourceRoot":"","sources":["../../../src/components/HxIcon/HxIcon.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,uDAMjB,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"HxIcon.d.ts","sourceRoot":"","sources":["../../../src/components/HxIcon/HxIcon.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,MAAM,uDAMjB,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/components/HxIcon/types.d.ts

@@ -12,6 +12,17 @@ export interface HxIconProps {
   starts with `#` it is used as-is (inline sprite reference without a base
   URL). */
     name?: string;
+    /** Identifier of the icon library to resolve `name` through. Default is
+  the empty string — meaning bare `<hx-icon name="foo">` continues to
+  render a document-local sprite fragment (`<use href="#foo">`) per the
+  pre-3.9.0 contract. Set explicitly to `'fa-free'` for the FA Free Solid
+  set bundled with `@helixui/icons`, `'helix'` for the curated 32-glyph
+  helix set, or to any consumer-registered library identifier.
+  
+  Library resolution applies only when `src` is empty AND `sprite-url` is
+  not set; the inline-fetch and explicit-sprite paths are kept as escape
+  hatches and ignore the library attribute. */
+    library?: string;
     /** URL of a standalone SVG file to fetch and render inline. Takes precedence
   over sprite mode when both `src` and `spriteUrl`/`name` are set.
   
@@ -26,7 +37,8 @@ export interface HxIconProps {
   Set via the `hx-size` HTML attribute (e.g. `hx-size="lg"`) or via the
   `size` JavaScript property (e.g. `el.size = 'lg'`). Both are equivalent —
   the `attribute: 'hx-size'` mapping is used to avoid colliding with the
-  native `<input>` `size` attribute in Drupal attribute-passthrough scenarios.
+  native HTMLInputElement `size` attribute in Drupal attribute-passthrough
+  scenarios.
   The CEM exposes both the JS property name (`size`) and the HTML attribute
   name (`hx-size`). */
     size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';

package/dist/components/HxIcon/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxIcon/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,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;;;;UAIM;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;+EAI2E;IAC3E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;8CAC0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;;;;sBAOkB;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC;;;aAGS;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;uGAEmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HxIcon/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,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;;;;UAIM;IACN,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;8CAS0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;+EAI2E;IAC3E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;8CAC0C;IAC1C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;;;;;sBAQkB;IAClB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC;;;aAGS;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;uGAEmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/shared/HxIcon-oYdBXU9x.js.map

@@ -1 +1 @@
-{"version":3,"file":"HxIcon-oYdBXU9x.js","sources":["../../src/components/HxIcon/HxIcon.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-icon> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixIcon } from '@helixui/library/components/hx-icon';\n\nimport type { HxIconProps } from './types.js';\n\nexport type { HxIconProps };\n\n/**\n * An icon component that supports inline SVG fetching and SVG sprite sheet references.\nDecorative icons are automatically hidden from assistive technology.\nWhen a label is provided the icon is announced as an image with that label.\n\n**Render modes:**\n- **Sprite mode** (recommended for Drupal/SSR): Set `name` and optionally `sprite-url`.\n  Renders an `<svg><use href=\"...#name\">` — works server-side without JavaScript.\n- **Inline mode**: Set `src` to a URL of a standalone SVG file. The component fetches,\n  sanitizes, and embeds the SVG markup. Requires JavaScript; not server-side renderable.\n  For Drupal/Twig templates use sprite mode to avoid content shift before hydration.\n *\n * @example\n * ```tsx\n * import { HxIcon } from '@helixui/react';\n *\n * <HxIcon />\n * ```\n */\nexport const HxIcon = createComponent({\n  tagName: 'hx-icon',\n  elementClass: HelixIcon,\n  react: React,\n  events: {},\n  displayName: 'HxIcon',\n});\n\nexport default HxIcon;\n"],"names":[],"mappings":";;;AAkCO,MAAM,SAAS,gBAAgB;AAAA,EACpC,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ,CAAA;AAAA,EACR,aAAa;AACf,CAAC;"}
+{"version":3,"file":"HxIcon-oYdBXU9x.js","sources":["../../src/components/HxIcon/HxIcon.ts"],"sourcesContent":["'use client';\n/**\n * React wrapper for <hx-icon> web component.\n * Auto-generated by scripts/generate-react-wrappers.ts — DO NOT EDIT MANUALLY.\n * Re-run: pnpm --filter=@helixui/react run generate\n */\n\nimport React from 'react';\nimport { createComponent } from '@lit/react';\nimport { HelixIcon } from '@helixui/library/components/hx-icon';\n\nimport type { HxIconProps } from './types.js';\n\nexport type { HxIconProps };\n\n/**\n * An icon component that resolves through the `@helixui/icons` registry,\nwith sprite-sheet and inline-fetch escape hatches for legacy / consumer\npatterns. Decorative icons are automatically hidden from assistive\ntechnology. When a label is provided the icon is announced as an image\nwith that label.\n\n**Render modes (in resolution order):**\n1. **Inline fetch (`src`)** — Set `src` to a URL of a standalone SVG file.\n   The component fetches, sanitizes, and embeds the SVG markup. Requires\n   JavaScript; not server-side renderable. Library attribute is ignored.\n2. **Explicit sprite (`sprite-url` + `name`)** — Pin the sprite URL on the\n   element instead of resolving through the registry. Library attribute is\n   ignored.\n3. **Registry (`library` + `name`)** (recommended) — Resolves through the\n   `@helixui/icons` registry. Set `library=\"fa-free\"` for the FA Free Solid\n   set bundled with `@helixui/icons`, or `library=\"helix\"` for the curated\n   32-glyph helix set. Consumer libraries register via `registerIconLibrary()`\n   and become resolvable here without modifying the component.\n4. **Bare name (`name` only, no `library`)** — `library` defaults to the\n   empty string. The component emits `<use href=\"#name\">` against a\n   document-local sprite — pre-3.9.0 back-compat behavior. Consumers\n   opt INTO registry resolution by setting `library` explicitly.\n5. **No name / no src** — Renders nothing.\n *\n * @example\n * ```tsx\n * import { HxIcon } from '@helixui/react';\n *\n * <HxIcon />\n * ```\n */\nexport const HxIcon = createComponent({\n  tagName: 'hx-icon',\n  elementClass: HelixIcon,\n  react: React,\n  events: {},\n  displayName: 'HxIcon',\n});\n\nexport default HxIcon;\n"],"names":[],"mappings":";;;AA+CO,MAAM,SAAS,gBAAgB;AAAA,EACpC,SAAS;AAAA,EACT,cAAc;AAAA,EACd,OAAO;AAAA,EACP,QAAQ,CAAA;AAAA,EACR,aAAa;AACf,CAAC;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@helixui/react",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "React wrappers for HELiX web components",
   "type": "module",
   "sideEffects": false,
@@ -24,7 +24,7 @@
   "dependencies": {
     "@lit/react": "^1.0.6",
     "react": "^18.3.1",
-    "@helixui/library": "3.8.0"
+    "@helixui/library": "3.9.0"
   },
   "devDependencies": {
     "@types/react": "^18.3.18",