@helixui/library 0.1.0

package/dist/components/hx-help-text/hx-help-text.d.ts

@@ -0,0 +1,44 @@
+import { LitElement } from 'lit';
+/**
+ * Standardized help/hint text displayed below form fields.
+ * Used by hx-field as a consistent sub-component for guidance and validation messages.
+ *
+ * Non-default variants render an inline icon alongside the text to satisfy
+ * WCAG 1.4.1 (color is not the sole visual indicator). The `error` variant
+ * uses `role="alert"` for immediate screen-reader announcement; `warning`
+ * and `success` use `aria-live="polite"` for non-intrusive announcements.
+ *
+ * @summary Help text displayed below form controls for guidance or validation feedback.
+ *
+ * @tag hx-help-text
+ *
+ * @slot - The help text content.
+ *
+ * @csspart base - The root element of the help text.
+ * @csspart icon - The icon wrapper (only rendered for non-default variants).
+ * @csspart text - The text wrapper around the default slot.
+ *
+ * @cssprop [--hx-help-text-color=var(--hx-color-neutral-500)] - Text color.
+ * @cssprop [--hx-help-text-font-family=var(--hx-font-family-sans)] - Font family.
+ * @cssprop [--hx-help-text-font-size=var(--hx-font-size-sm)] - Font size.
+ * @cssprop [--hx-help-text-font-weight=var(--hx-font-weight-normal)] - Font weight.
+ * @cssprop [--hx-help-text-line-height=var(--hx-line-height-normal)] - Line height.
+ * @cssprop [--hx-help-text-icon-gap=0.375rem] - Gap between icon and text.
+ */
+export declare class HelixHelpText extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Visual variant that determines the text color and icon.
+     * Use `error` for validation errors, `warning` for cautions, `success` for confirmation.
+     * @attr variant
+     */
+    variant: 'default' | 'error' | 'warning' | 'success';
+    render(): import('lit-html').TemplateResult<1>;
+}
+export type WcHelpText = HelixHelpText;
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-help-text': HelixHelpText;
+    }
+}
+//# sourceMappingURL=hx-help-text.d.ts.map

package/dist/components/hx-help-text/hx-help-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-help-text.d.ts","sourceRoot":"","sources":["../../../src/components/hx-help-text/hx-help-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AA+DhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAE5D;;;;OAIG;IAEH,OAAO,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAa;IAExD,MAAM;CAqBhB;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

package/dist/components/hx-help-text/hx-help-text.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixHelpTextStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-help-text.styles.d.ts.map

package/dist/components/hx-help-text/hx-help-text.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-help-text.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-help-text/hx-help-text.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAkD/B,CAAC"}

package/dist/components/hx-help-text/index.d.ts

@@ -0,0 +1,2 @@
+export { HelixHelpText } from './hx-help-text.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/hx-help-text/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-help-text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/hx-help-text/index.js

@@ -0,0 +1,5 @@
+import { H } from "../../shared/hx-help-text-C3WCP11-.js";
+export {
+  H as HelixHelpText
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-help-text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/hx-icon/hx-icon.d.ts

@@ -0,0 +1,115 @@
+import { LitElement, nothing } from 'lit';
+/**
+ * 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.
+ *
+ * **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.
+ *
+ * @summary SVG icon with sprite and inline fetch modes for healthcare applications.
+ *
+ * @tag hx-icon
+ *
+ * @csspart svg - The SVG element rendered in sprite mode, or the inline SVG container
+ *   in inline mode. In sprite mode this is an `<svg>` element; in inline mode it is a
+ *   `<span>` element wrapping the fetched SVG. Both expose the same `part` name for
+ *   consistent external styling via `::part(svg)`.
+ *
+ * @cssprop [--hx-icon-size=var(--hx-size-6,1.5rem)] - Width and height of the icon.
+ * @cssprop [--hx-icon-color=currentColor] - Icon color.
+ */
+export declare class HelixIcon extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Icon name used as the fragment identifier when referencing a sprite sheet.
+     * For sprite mode provide the bare symbol id (e.g. `check`). The component
+     * will build the full href as `${spriteUrl}#${name}`. If `name` already
+     * starts with `#` it is used as-is (inline sprite reference without a base
+     * URL).
+     * @attr name
+     */
+    name: 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.
+     *
+     * **Note:** Inline mode requires browser JavaScript (`fetch` + `DOMParser`).
+     * It is not server-side renderable. For Drupal/Twig use sprite mode instead.
+     * @attr src
+     */
+    src: string | undefined;
+    /**
+     * Base URL of the SVG sprite sheet. Used together with `name` to construct
+     * the `<use>` href: `${spriteUrl}#${name}`.
+     * @attr sprite-url
+     */
+    spriteUrl: string | undefined;
+    /**
+     * Size variant of the icon.
+     *
+     * 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.
+     * The CEM exposes both the JS property name (`size`) and the HTML attribute
+     * name (`hx-size`).
+     *
+     * @attr hx-size
+     */
+    size: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Accessible label for the icon. When non-empty, `role="img"` and
+     * `aria-label` are applied so assistive technology announces the icon.
+     * When empty the icon is treated as decorative and `aria-hidden="true"` is
+     * applied.
+     * @attr label
+     */
+    label: string;
+    /**
+     * Stores the sanitized inner markup of an externally fetched SVG.
+     */
+    private _inlineSvg;
+    /**
+     * Tracks the `src` URL that was last successfully fetched so that we only
+     * refetch when it genuinely changes.
+     */
+    private _fetchedSrc;
+    /**
+     * Monotonically-increasing sequence number. Incremented before each fetch so
+     * that stale out-of-order responses can be discarded.
+     */
+    private _fetchSeq;
+    updated(changed: Map<string, unknown>): void;
+    private _fetchInlineSvg;
+    /**
+     * Parses the raw SVG text, strips dangerous content (script elements,
+     * foreignObject, on* event-handler attributes, javascript:/data: URIs,
+     * and style attributes that could carry CSS injection payloads), and
+     * returns the outer SVG markup safe for rendering via `unsafeHTML`.
+     *
+     * Additionally injects `focusable="false"` on the root SVG element to
+     * prevent IE11/old-Edge from making the SVG keyboard-focusable, and strips
+     * any ARIA attributes from the inner SVG to prevent conflicts with the
+     * wrapper's own ARIA semantics.
+     */
+    private _sanitizeSvg;
+    /**
+     * Returns the href used in the `<use>` element for sprite mode.
+     * If `name` already begins with `#` it is treated as an inline reference.
+     */
+    private _spriteHref;
+    private _renderSprite;
+    private _renderInline;
+    render(): typeof nothing | import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-icon': HelixIcon;
+    }
+}
+//# sourceMappingURL=hx-icon.d.ts.map

package/dist/components/hx-icon/hx-icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-icon.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon/hx-icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,OAAO,EAAE,MAAM,KAAK,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,4BAAkC;IAExD;;;;;;;OAOG;IAEH,IAAI,SAAM;IAEV;;;;;;;OAOG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAEpC;;;;OAIG;IAEH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAa;IAE1C;;;;;;;;;;;OAWG;IAEH,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE9C;;;;;;OAMG;IAEH,KAAK,SAAM;IAEX;;OAEG;IAEH,OAAO,CAAC,UAAU,CAAM;IAExB;;;OAGG;IAEH,OAAO,CAAC,WAAW,CAAiC;IAEpD;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAK;IAIb,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;YAQvC,eAAe;IA4C7B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAkEpB;;;OAGG;IACH,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,aAAa;IA0BZ,MAAM;CAahB;AAUD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/dist/components/hx-icon/hx-icon.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixIconStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-icon.styles.d.ts.map

package/dist/components/hx-icon/hx-icon.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-icon.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon/hx-icon.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,yBAyE3B,CAAC"}

package/dist/components/hx-icon/index.d.ts

@@ -0,0 +1,2 @@
+export { HelixIcon } from './hx-icon.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/hx-icon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-icon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/hx-icon/index.js

@@ -0,0 +1,5 @@
+import { H as r } from "../../shared/hx-icon-CxOk7jZe.js";
+export {
+  r as HelixIcon
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-icon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/hx-image/hx-image.d.ts

@@ -0,0 +1,120 @@
+import { LitElement } from 'lit';
+/**
+ * An accessible image wrapper with lazy loading, fallback support, aspect ratio control,
+ * responsive image (srcset/sizes) support, and optional caption.
+ *
+ * @summary Accessible image wrapper with lazy loading, fallback, srcset, and aspect ratio control.
+ *
+ * @tag hx-image
+ *
+ * @slot fallback - Custom content shown when the image fails to load and no fallback-src is set.
+ * @slot caption - Optional caption content rendered in a figcaption element below the image.
+ *
+ * @csspart base - The inner img element.
+ * @csspart caption - The figcaption element (visible only when caption content is present).
+ *
+ * @cssprop [--hx-image-object-fit] - Controls how the image fills its container. Maps to object-fit.
+ * @cssprop [--hx-image-border-radius] - Border radius of the image. Overridden by the `rounded` prop.
+ * @cssprop [--hx-image-aspect-ratio] - Aspect ratio of the image container. Overridden by the `ratio` prop.
+ * @cssprop [--hx-image-caption-color] - Text color for the caption.
+ * @cssprop [--hx-image-caption-font-size] - Font size for the caption.
+ * @cssprop [--hx-image-caption-padding] - Padding for the caption.
+ * @cssprop [--hx-image-fallback-min-height] - Minimum height of the error/fallback container.
+ *
+ * @fires hx-load - Dispatched when the image has successfully loaded.
+ * @fires hx-error - Dispatched when the image fails to load (including after fallback-src also fails).
+ */
+export declare class HelixImage extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * The URL of the image to display.
+     * @attr src
+     */
+    src: string;
+    /**
+     * Accessible text description of the image.
+     * Required for informative images. Use the `decorative` prop for decorative images
+     * instead of setting this to an empty string — explicit decorative intent is preferred.
+     * @attr alt
+     */
+    alt: string | undefined;
+    /**
+     * Marks the image as decorative (hidden from screen readers).
+     * Use this instead of `alt=""` to make decorative intent explicit in markup.
+     * When set, the inner img receives `alt=""` and `role="presentation"`.
+     * @attr decorative
+     */
+    decorative: boolean;
+    /**
+     * Width of the image element.
+     * @attr width
+     */
+    width: number | string | undefined;
+    /**
+     * Height of the image element.
+     * @attr height
+     */
+    height: number | string | undefined;
+    /**
+     * Loading strategy for the image.
+     * @attr loading
+     */
+    loading: 'lazy' | 'eager';
+    /**
+     * How the image should be resized to fit its container.
+     * Maps to CSS object-fit.
+     * @attr fit
+     */
+    fit: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down' | undefined;
+    /**
+     * CSS aspect-ratio value (e.g. "16/9", "1", "4/3").
+     * When set, the container maintains this ratio.
+     * @attr ratio
+     */
+    ratio: string | undefined;
+    /**
+     * Border radius for the image.
+     * Boolean attribute (or `true`) applies the theme's medium radius token.
+     * A string value is used directly as a CSS border-radius value (e.g. "1rem", "50%").
+     *
+     * Note: When set as an HTML attribute (`<hx-image rounded>`), Lit receives the value as
+     * an empty string (`''`). When set programmatically (`el.rounded = true`), it receives
+     * a boolean. Both forms apply the theme radius token.
+     *
+     * @attr rounded
+     */
+    rounded: boolean | string | undefined;
+    /**
+     * Fallback image URL shown when the primary src fails to load.
+     * @attr fallback-src
+     */
+    fallbackSrc: string | undefined;
+    /**
+     * A comma-separated list of image candidates for responsive images.
+     * Passed directly to the inner img's srcset attribute.
+     * Enables Drupal responsive image styles and browser-native image selection.
+     * @attr srcset
+     */
+    srcset: string | undefined;
+    /**
+     * Media conditions indicating which image size to use alongside srcset.
+     * Works in conjunction with the `srcset` attribute.
+     * @attr sizes
+     */
+    sizes: string | undefined;
+    private _error;
+    private _usedFallbackSrc;
+    private _hasCaptionSlot;
+    private _handleLoad;
+    private _handleError;
+    private _onCaptionSlotChange;
+    private _computeBorderRadius;
+    private _currentSrc;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-image': HelixImage;
+    }
+}
+//# sourceMappingURL=hx-image.d.ts.map

package/dist/components/hx-image/hx-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-image.d.ts","sourceRoot":"","sources":["../../../src/components/hx-image/hx-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAOhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,UAAW,SAAQ,UAAU;IACxC,OAAgB,MAAM,4BAAmC;IAEzD;;;OAGG;IAEH,GAAG,SAAM;IAET;;;;;OAKG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAEpC;;;;;OAKG;IAEH,UAAU,UAAS;IAEnB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAa;IAE/C;;;OAGG;IAEH,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAa;IAEhD;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,OAAO,CAAU;IAEnC;;;;OAIG;IAEH,GAAG,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAa;IAElF;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;;;;;;;OAUG;IAEH,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAa;IAElD;;;OAGG;IAEH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAa;IAE5C;;;;;OAKG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;;OAIG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAGtC,OAAO,CAAC,MAAM,CAAS;IAGvB,OAAO,CAAC,gBAAgB,CAAS;IAGjC,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,WAAW;IAOV,MAAM;CAwDhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,UAAU,EAAE,UAAU,CAAC;KACxB;CACF"}

package/dist/components/hx-image/hx-image.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixImageStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-image.styles.d.ts.map

package/dist/components/hx-image/hx-image.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-image.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-image/hx-image.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,yBAyC5B,CAAC"}

package/dist/components/hx-image/index.d.ts

@@ -0,0 +1,2 @@
+export { HelixImage } from './hx-image.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/hx-image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/components/hx-image/index.js

@@ -0,0 +1,5 @@
+import { H as m } from "../../shared/hx-image-CZPw1AiF.js";
+export {
+  m as HelixImage
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/hx-link/hx-link.d.ts

@@ -0,0 +1,84 @@
+import { LitElement } from 'lit';
+/**
+ * Variant options for the link component.
+ */
+export type LinkVariant = 'default' | 'subtle' | 'danger';
+/**
+ * A semantic hyperlink component with accessibility-first design.
+ * Renders a native `<a>` element for enabled state and a `<span>` for
+ * disabled state with full keyboard and screen reader support.
+ *
+ * @summary Accessible hyperlink with external-link detection, disabled state,
+ *   and download support.
+ *
+ * @tag hx-link
+ *
+ * @slot - Default slot for link label text or content.
+ *
+ * @fires {CustomEvent<{originalEvent: MouseEvent}>} hx-click - Dispatched when
+ *   the link is clicked and is not disabled.
+ *
+ * @csspart link - The inner anchor or span element.
+ * @csspart external-icon - The external link icon SVG (when target="_blank").
+ *
+ * @cssprop [--hx-link-color=var(--hx-color-primary-500)] - Default link color.
+ * @cssprop [--hx-link-color-hover=var(--hx-color-primary-700)] - Hover color.
+ * @cssprop [--hx-link-color-active=var(--hx-color-primary-800)] - Active color.
+ * @cssprop [--hx-link-color-disabled=var(--hx-color-neutral-400)] - Disabled color.
+ * @cssprop [--hx-link-color-subtle=var(--hx-color-neutral-600)] - Subtle variant color.
+ * @cssprop [--hx-link-color-danger=var(--hx-color-error-500)] - Danger variant color.
+ * @cssprop [--hx-link-text-decoration=underline] - Link text decoration.
+ * @cssprop [--hx-link-focus-ring-color=var(--hx-focus-ring-color)] - Focus ring color.
+ *
+ * @note The `:visited` pseudo-class does not work inside Shadow DOM due to
+ *   browser privacy restrictions. This is a known platform limitation.
+ */
+export declare class HelixLink extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * The URL the link points to.
+     * @attr href
+     */
+    href: string | undefined;
+    /**
+     * Where to display the linked URL (_self, _blank, etc.).
+     * When set to "_blank", automatically adds rel="noopener noreferrer"
+     * and shows an external-link indicator.
+     * @attr target
+     */
+    target: string | undefined;
+    /**
+     * Visual style variant of the link.
+     * @attr variant
+     */
+    variant: LinkVariant;
+    /**
+     * Whether the link is disabled. Renders a span instead of an anchor.
+     * The disabled span is keyboard-focusable (tabindex="0") and announces
+     * as a disabled link to screen readers.
+     * @attr disabled
+     */
+    disabled: boolean;
+    /**
+     * Prompts the user to download the linked URL. When set to a string,
+     * the value is used as the suggested filename.
+     * @attr download
+     */
+    download: string | undefined;
+    /**
+     * Relationship between the current document and the linked URL.
+     * Automatically set to "noopener noreferrer" when target="_blank".
+     * @attr rel
+     */
+    rel: string | undefined;
+    private _handleClick;
+    private _computeRel;
+    private _renderExternalIcon;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-link': HelixLink;
+    }
+}
+//# sourceMappingURL=hx-link.d.ts.map

package/dist/components/hx-link/hx-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-link.d.ts","sourceRoot":"","sources":["../../../src/components/hx-link/hx-link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAOrD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,4BAAkC;IAExD;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;;;OAKG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAa;IAEvC;;;OAGG;IAEH,OAAO,EAAE,WAAW,CAAa;IAEjC;;;;;OAKG;IAEH,QAAQ,UAAS;IAEjB;;;;OAIG;IAEH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IAEzC;;;;OAIG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAa;IAIpC,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,mBAAmB;IAuBlB,MAAM;CAqChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/dist/components/hx-link/hx-link.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixLinkStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-link.styles.d.ts.map

package/dist/components/hx-link/hx-link.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-link.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-link/hx-link.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,yBAiG3B,CAAC"}

package/dist/components/hx-link/index.d.ts

@@ -0,0 +1,3 @@
+export { HelixLink } from './hx-link.js';
+export type { LinkVariant } from './hx-link.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/hx-link/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/hx-link/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/hx-link/index.js

@@ -0,0 +1,5 @@
+import { H as o } from "../../shared/hx-link-DObQ7eS4.js";
+export {
+  o as HelixLink
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-link/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/hx-list/hx-list-item.d.ts

@@ -0,0 +1,79 @@
+import { LitElement } from 'lit';
+/**
+ * A rich list item for use inside `hx-list`.
+ *
+ * @summary Individual list item with optional prefix, suffix, description, link, and disabled/selected states.
+ *
+ * @tag hx-list-item
+ *
+ * @slot - Default slot for the item label text.
+ * @slot prefix - Icon, avatar, or content rendered before the label.
+ * @slot suffix - Icon, badge, or text rendered after the label.
+ * @slot description - Secondary descriptive text rendered below the label.
+ *
+ * @fires {CustomEvent<{item: HelixListItem, value: string | undefined}>} hx-list-item-click -
+ *   Dispatched when the item is clicked and not disabled.
+ *
+ * @csspart base - The root item element (li, dt, dd, or wrapper).
+ * @csspart prefix - The prefix slot container.
+ * @csspart label - The label slot container.
+ * @csspart description - The description slot container.
+ * @csspart suffix - The suffix slot container.
+ *
+ * @cssprop [--hx-list-item-padding=var(--hx-space-3)] - Item padding.
+ * @cssprop [--hx-list-item-color=var(--hx-color-neutral-900)] - Item text color.
+ * @cssprop [--hx-list-item-bg-hover=var(--hx-color-neutral-50)] - Item hover background.
+ * @cssprop [--hx-list-item-bg-selected=var(--hx-color-primary-50)] - Selected item background.
+ * @cssprop [--hx-list-item-color-selected=var(--hx-color-primary-700)] - Selected item text color.
+ * @cssprop [--hx-list-item-description-color=var(--hx-color-neutral-500)] - Description text color.
+ */
+export declare class HelixListItem extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Whether the item is disabled. Prevents interaction.
+     * @attr disabled
+     */
+    disabled: boolean;
+    /**
+     * Whether the item is selected (used in interactive mode).
+     * @attr selected
+     */
+    selected: boolean;
+    /**
+     * When set, renders the item as a link (only in non-interactive variants).
+     * @attr href
+     */
+    href: string | undefined;
+    /**
+     * The value associated with this item (used with hx-select).
+     * @attr value
+     */
+    value: string | undefined;
+    /**
+     * Set by the parent hx-list to indicate this item is part of an interactive listbox.
+     * Controls CSS styling and ARIA role via host attributes.
+     * @attr interactive
+     */
+    interactive: boolean;
+    /**
+     * Item type for description list variant. Use 'term' for <dt> and 'definition' for <dd>.
+     * @attr type
+     */
+    type: 'default' | 'term' | 'definition';
+    updated(changedProps: Map<string, unknown>): void;
+    /**
+     * Syncs ARIA attributes to the host element when in interactive (listbox option) mode.
+     * This ensures correct ARIA ownership: ul[role=listbox] > hx-list-item[role=option].
+     */
+    private _syncHostAria;
+    private _handleClick;
+    private _renderContent;
+    render(): import('lit-html').TemplateResult<1>;
+    private _handleKeydown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-list-item': HelixListItem;
+    }
+}
+//# sourceMappingURL=hx-list-item.d.ts.map

package/dist/components/hx-list/hx-list-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-list-item.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAE5D;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAa;IAErC;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAEtC;;;;OAIG;IAEH,WAAW,UAAS;IAEpB;;;OAGG;IAEH,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,CAAa;IAE3C,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW1D;;;OAGG;IACH,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,cAAc;IAmBb,MAAM;IA+Ef,OAAO,CAAC,cAAc;CAQvB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

package/dist/components/hx-list/hx-list-item.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixListItemStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-list-item.styles.d.ts.map

package/dist/components/hx-list/hx-list-item.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-list-item.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list-item.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,yBAsG/B,CAAC"}

package/dist/components/hx-list/hx-list.d.ts

@@ -0,0 +1,54 @@
+import { LitElement } from 'lit';
+/**
+ * A styled list container supporting plain, bulleted, numbered, description, and interactive variants.
+ *
+ * @summary Container for list items with optional dividers and interactive selection.
+ *
+ * @tag hx-list
+ *
+ * @slot - Default slot for `hx-list-item` elements.
+ *
+ * @fires {CustomEvent<{item: HelixListItem, value: string | undefined}>} hx-select - Dispatched
+ *   when an item is clicked in interactive mode.
+ *
+ * @csspart base - The root list element.
+ *
+ * @cssprop [--hx-list-gap=0] - Gap between list items.
+ * @cssprop [--hx-list-divider-color=var(--hx-color-neutral-200)] - Divider line color.
+ */
+export declare class HelixList extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Visual variant of the list.
+     * @attr variant
+     */
+    variant: 'plain' | 'bulleted' | 'numbered' | 'description' | 'interactive';
+    /**
+     * Whether to show dividers between list items.
+     * @attr divided
+     */
+    divided: boolean;
+    /**
+     * Accessible label for the list. Required when variant is "interactive" (listbox role).
+     * @attr label
+     */
+    label: string | undefined;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changedProps: Map<string, unknown>): void;
+    /**
+     * Sets the `interactive` property on all child hx-list-item elements
+     * so they can style and behave correctly without `:host-context()`.
+     */
+    private _updateItemStates;
+    private _handleSlotChange;
+    private readonly _handleKeydown;
+    private _handleItemClick;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-list': HelixList;
+    }
+}
+//# sourceMappingURL=hx-list.d.ts.map

package/dist/components/hx-list/hx-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-list.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAOhD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,4BAAkC;IAExD;;;OAGG;IAEH,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAW;IAErF;;;OAGG;IAEH,OAAO,UAAS;IAEhB;;;OAGG;IAEH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAa;IAE7B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAa1D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAiC7B;IAEF,OAAO,CAAC,gBAAgB;IAgBf,MAAM;CA+ChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

package/dist/components/hx-list/hx-list.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const helixListStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-list.styles.d.ts.map

package/dist/components/hx-list/hx-list.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-list.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-list/hx-list.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,yBAgD3B,CAAC"}