@helixui/library 0.1.0

package/dist/components/hx-file-upload/hx-file-upload.d.ts

@@ -0,0 +1,138 @@
+import { LitElement } from 'lit';
+/**
+ * A drag-and-drop file upload component with client-side validation,
+ * file list management, per-file progress, and native form association.
+ *
+ * @summary Form-associated file upload dropzone with drag-and-drop, validation, and progress tracking.
+ *
+ * @tag hx-file-upload
+ *
+ * @slot - Default dropzone content. Replaces the built-in "Drag files here or click to browse" prompt.
+ * @slot file-list - Custom file list display. When provided, the built-in file list is hidden.
+ *
+ * @fires {CustomEvent<{files: File[]}>} hx-upload - Dispatched when valid files are selected via drag-and-drop or the file picker.
+ * @fires {CustomEvent<{file: File, index: number}>} hx-remove - Dispatched when a file is removed from the list.
+ * @fires {CustomEvent<{message: string, files: File[]}>} hx-error - Dispatched when file validation fails (type or size constraint).
+ *
+ * @csspart dropzone - The drag-and-drop target area.
+ * @csspart file-list - The container wrapping the list of selected files.
+ * @csspart file-item - An individual file entry in the list.
+ * @csspart progress - The progress bar track for a file item.
+ * @csspart label - The visible label element.
+ *
+ * @cssprop [--hx-file-upload-dropzone-bg=var(--hx-color-neutral-50)] - Dropzone background color.
+ * @cssprop [--hx-file-upload-dropzone-border-color=var(--hx-color-neutral-300)] - Dropzone border color.
+ * @cssprop [--hx-file-upload-dropzone-border-radius=var(--hx-border-radius-lg)] - Dropzone border radius.
+ * @cssprop [--hx-file-upload-dropzone-active-bg] - Dropzone background when a file is dragged over.
+ * @cssprop [--hx-file-upload-progress-color=var(--hx-color-primary-500)] - Progress bar fill color.
+ * @cssprop [--hx-file-upload-error-color=var(--hx-color-error-500)] - Error state and remove-button hover color.
+ */
+export declare class HelixFileUpload extends LitElement {
+    static styles: import('lit').CSSResult[];
+    static formAssociated: boolean;
+    private _internals;
+    constructor();
+    /**
+     * The form field name used during form submission.
+     * @attr name
+     */
+    name: string;
+    /**
+     * Accepted file types as a comma-separated list of MIME types or extensions.
+     * Mirrors the native `<input type="file" accept>` attribute.
+     * @attr accept
+     */
+    accept: string;
+    /**
+     * Maximum allowed file size in bytes. 0 means unlimited.
+     * @attr max-size
+     */
+    maxSize: number;
+    /**
+     * Maximum number of files that can be selected. 0 means unlimited.
+     * @attr max-files
+     */
+    maxFiles: number;
+    /**
+     * Whether multiple files may be selected at once.
+     * @attr multiple
+     */
+    multiple: boolean;
+    /**
+     * Visible label text for the dropzone.
+     * @attr label
+     */
+    label: string;
+    /**
+     * Whether the component is disabled.
+     * @attr disabled
+     */
+    disabled: boolean;
+    /**
+     * Error message displayed below the dropzone. Also puts the dropzone in an error visual state.
+     * @attr error
+     */
+    error: string;
+    private _files;
+    private _dragOver;
+    private _hasFileListSlot;
+    private _fileInput;
+    private readonly _baseId;
+    private readonly _labelId;
+    private readonly _errorId;
+    private readonly _dropzoneId;
+    private readonly _liveId;
+    private _handleFileListSlotChange;
+    updated(changedProperties: Map<string, unknown>): void;
+    /** Returns the associated form element, if any. */
+    get form(): HTMLFormElement | null;
+    /** Returns the validation message. */
+    get validationMessage(): string;
+    /** Returns the ValidityState object. */
+    get validity(): ValidityState;
+    /** Checks whether the component satisfies its constraints. */
+    checkValidity(): boolean;
+    /** Reports validity and shows the browser's constraint validation UI. */
+    reportValidity(): boolean;
+    /** Called by the form when it resets. */
+    formResetCallback(): void;
+    private _syncFormValue;
+    /**
+     * Validates a file against `accept` and `maxSize` constraints.
+     * Returns null on success, or an error message string on failure.
+     */
+    private _validateFile;
+    /**
+     * Checks whether a file is accepted given the `accept` attribute value.
+     * Handles MIME types (e.g. "image/png"), wildcard MIME types (e.g. "image/*"),
+     * and extensions (e.g. ".pdf").
+     */
+    private _isAccepted;
+    private _processFiles;
+    /**
+     * Sets the upload progress for a file at the given index.
+     * @param index - Zero-based index into the current file list.
+     * @param percent - Progress percentage from 0 to 100.
+     */
+    setProgress(index: number, percent: number): void;
+    /**
+     * Returns a read-only copy of the currently selected files.
+     */
+    get files(): File[];
+    private _handleDragOver;
+    private _handleDragLeave;
+    private _handleDrop;
+    private _handleDropzoneClick;
+    private _handleDropzoneKeyDown;
+    private _handleFileInputChange;
+    private _handleRemove;
+    private _formatSize;
+    private _renderFileList;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-file-upload': HelixFileUpload;
+    }
+}
+//# sourceMappingURL=hx-file-upload.d.ts.map

package/dist/components/hx-file-upload/hx-file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-file-upload.d.ts","sourceRoot":"","sources":["../../../src/components/hx-file-upload/hx-file-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAgBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAAwC;IAI9D,MAAM,CAAC,cAAc,UAAQ;IAE7B,OAAO,CAAC,UAAU,CAAmB;;IASrC;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;;OAIG;IAEH,MAAM,SAAM;IAEZ;;;OAGG;IAEH,OAAO,SAAK;IAEZ;;;OAGG;IAEH,QAAQ,SAAK;IAEb;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAEX;;;OAGG;IAEH,QAAQ,UAAS;IAEjB;;;OAGG;IAEH,KAAK,SAAM;IAIF,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IAK1C,OAAO,CAAC,UAAU,CAA2B;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgD;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAIlD,OAAO,CAAC,yBAAyB;IAOxB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS/D,mDAAmD;IACnD,IAAI,IAAI,IAAI,eAAe,GAAG,IAAI,CAEjC;IAED,sCAAsC;IACtC,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,wCAAwC;IACxC,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED,8DAA8D;IAC9D,aAAa,IAAI,OAAO;IAIxB,yEAAyE;IACzE,cAAc,IAAI,OAAO;IAIzB,yCAAyC;IACzC,iBAAiB,IAAI,IAAI;IAKzB,OAAO,CAAC,cAAc;IAyBtB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAsBnB,OAAO,CAAC,aAAa;IAsFrB;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjD;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAID,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,eAAe;IA0Dd,MAAM;CA4EhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}

package/dist/components/hx-file-upload/hx-file-upload.styles.d.ts

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

package/dist/components/hx-file-upload/hx-file-upload.styles.d.ts.map

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

package/dist/components/hx-file-upload/index.d.ts

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

package/dist/components/hx-file-upload/index.d.ts.map

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

package/dist/components/hx-file-upload/index.js

@@ -0,0 +1,5 @@
+import { H as o } from "../../shared/hx-file-upload-Px6kRzAZ.js";
+export {
+  o as HelixFileUpload
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-file-upload/index.js.map

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

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

@@ -0,0 +1,141 @@
+import { LitElement } from 'lit';
+/**
+ * A Light DOM form wrapper that styles native HTML form elements and
+ * hx-* components with the design system's form styles.
+ *
+ * When `action` is set, renders a `<form>` wrapper around slotted content.
+ * When no `action` is set (the Drupal pattern), renders only a `<slot>`
+ * so Drupal can provide its own `<form>` tag.
+ *
+ * Uses adopted stylesheets to inject scoped CSS into the document without
+ * Shadow DOM, keeping native form participation and Drupal compatibility.
+ *
+ * @summary Light DOM form wrapper with scoped styles for native and hx-* form elements.
+ *
+ * @tag hx-form
+ *
+ * @slot - Default slot for form fields and controls.
+ *
+ * @fires {CustomEvent<{valid: boolean, values: Record<string, FormDataEntryValue | FormDataEntryValue[]>, formData: FormData}>} hx-submit - Dispatched on valid client-side submit when no action is set.
+ * @fires {CustomEvent<{errors: Array<{name: string, message: string}>}>} hx-invalid - Dispatched when validation fails on submit.
+ * @fires {CustomEvent} hx-reset - Dispatched when the form is reset.
+ *
+ * @cssprop [--hx-form-gap=var(--hx-space-4)] - Gap between form fields.
+ * @cssprop [--hx-form-max-width=none] - Maximum width of the form.
+ * @cssprop [--hx-form-padding=0] - Internal padding of the form.
+ */
+export declare class HelixForm extends LitElement {
+    createRenderRoot(): HTMLElement;
+    private _styles;
+    private _validationErrors;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * The URL to submit the form to. When empty, the form handles
+     * submission client-side only and dispatches `hx-submit`.
+     * @attr action
+     */
+    action: string;
+    /**
+     * The HTTP method used when submitting the form.
+     * @attr method
+     */
+    method: 'get' | 'post';
+    /**
+     * When true, disables the browser's built-in constraint validation
+     * on form submission.
+     * @attr novalidate
+     */
+    novalidate: boolean;
+    /**
+     * Identifies the form for scripting and form discovery.
+     * @attr name
+     */
+    name: string;
+    /**
+     * The encoding type for form submission. Only used when `action` is set.
+     * Use `multipart/form-data` for forms with file uploads.
+     * @attr enctype
+     */
+    enctype: 'application/x-www-form-urlencoded' | 'multipart/form-data' | 'text/plain';
+    /**
+     * Checks the validity of all child form elements without showing
+     * validation UI. Returns `true` if all elements are valid.
+     */
+    checkValidity(): boolean;
+    /**
+     * Checks validity and triggers the browser's constraint validation UI
+     * on each invalid element. Returns `true` if all elements are valid.
+     */
+    reportValidity(): boolean;
+    /**
+     * Collects form data from all child form elements (native and hx-*).
+     * Returns a `FormData` object.
+     */
+    getFormData(): FormData;
+    /**
+     * Returns all child hx-* form components that implement the form
+     * component contract (hx-text-input, hx-select, hx-checkbox, hx-textarea,
+     * hx-radio-group, hx-switch).
+     *
+     * Note: This uses a hardcoded allowlist. When a new hx-* form component
+     * is added, update this selector to include it.
+     */
+    getFormElements(): HTMLElement[];
+    /**
+     * Returns all native form elements (input, select, textarea, button)
+     * found within this component's light DOM.
+     */
+    getNativeFormElements(): Array<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLButtonElement>;
+    /**
+     * Programmatically sets server-side validation errors on the form.
+     * Renders an error summary and sets `aria-invalid="true"` on named fields.
+     *
+     * Useful for surfacing Drupal server-side validation responses.
+     *
+     * @param errors - Array of `{name, message}` pairs matching field `name` attributes.
+     */
+    setErrors(errors: Array<{
+        name: string;
+        message: string;
+    }>): void;
+    /**
+     * Programmatically sets a single field error. Merges with any existing errors.
+     *
+     * @param name - The `name` attribute of the field.
+     * @param message - The error message to display.
+     */
+    setFieldError(name: string, message: string): void;
+    /**
+     * Clears all validation errors from the error summary and removes
+     * `aria-invalid` from all fields.
+     */
+    clearErrors(): void;
+    /**
+     * Returns all elements that support constraint validation, including
+     * both native form elements and hx-* components with `checkValidity`.
+     */
+    private _getAllValidatableElements;
+    /**
+     * Sets `aria-invalid="true"` on fields with errors, removes it from valid fields.
+     */
+    private _applyAriaInvalidFromErrors;
+    /**
+     * Sets `aria-invalid` based on native constraint validation state.
+     */
+    private _applyAriaInvalidFromValidity;
+    /**
+     * Removes `aria-invalid` from all validatable elements.
+     */
+    private _clearAriaInvalid;
+    private _handleSubmit;
+    private _handleReset;
+    private _collectValidationErrors;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-form': HelixForm;
+    }
+}
+//# sourceMappingURL=hx-form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hx-form.d.ts","sourceRoot":"","sources":["../../../src/components/hx-form/hx-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,KAAK,CAAC;AAMhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBACa,SAAU,SAAQ,UAAU;IAG9B,gBAAgB,IAAI,WAAW;IAMxC,OAAO,CAAC,OAAO,CAAwE;IAKvF,OAAO,CAAC,iBAAiB,CAAgD;IAIhE,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAQrC;;;;OAIG;IAEH,MAAM,SAAM;IAEZ;;;OAGG;IAEH,MAAM,EAAE,KAAK,GAAG,MAAM,CAAU;IAEhC;;;;OAIG;IAEH,UAAU,UAAS;IAEnB;;;OAGG;IAEH,IAAI,SAAM;IAEV;;;;OAIG;IAEH,OAAO,EAAE,mCAAmC,GAAG,qBAAqB,GAAG,YAAY,CAC7C;IAItC;;;OAGG;IACH,aAAa,IAAI,OAAO;IAUxB;;;OAGG;IACH,cAAc,IAAI,OAAO;IAazB;;;OAGG;IACH,WAAW,IAAI,QAAQ;IA8BvB;;;;;;;OAOG;IACH,eAAe,IAAI,WAAW,EAAE;IAQhC;;;OAGG;IACH,qBAAqB,IAAI,KAAK,CAC5B,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,CAC/E;IAQD;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAKjE;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlD;;;OAGG;IACH,WAAW,IAAI,IAAI;IAOnB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,aAAa,CAsDnB;IAEF,OAAO,CAAC,YAAY,CAclB;IAEF,OAAO,CAAC,wBAAwB;IAqBvB,MAAM;CAoChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;KACtB;CACF"}

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

@@ -0,0 +1,2 @@
+export declare const helixFormScopedCss: string;
+//# sourceMappingURL=hx-form.styles.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,5 @@
+import { H as e } from "../../shared/hx-form-BJeLK34m.js";
+export {
+  e as HelixForm
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/hx-format-date/hx-format-date.d.ts

@@ -0,0 +1,120 @@
+import { LitElement } from 'lit';
+/**
+ * Formats and displays a date/time value using the browser's `Intl.DateTimeFormat`
+ * (or `Intl.RelativeTimeFormat` when `relative` is set). Renders as an inline
+ * `<time>` element — machine-readable via `datetime`, human-readable via formatted text.
+ *
+ * No external dependencies. Uses native Intl APIs only.
+ *
+ * @summary Inline date/time formatter using Intl APIs with semantic `<time>` output.
+ *
+ * @tag hx-format-date
+ *
+ * @csspart base - The inner `<time>` element.
+ */
+export declare class HelixFormatDate extends LitElement {
+    static styles: import('lit').CSSResult[];
+    private static _dtfCache;
+    private static _rtfCache;
+    /**
+     * The date/time value to format. Accepts an ISO string, a Unix timestamp (ms), or
+     * a `Date` object. Defaults to the current date/time when empty.
+     * @attr date
+     */
+    date: string | number | Date;
+    /**
+     * BCP 47 locale tag used for formatting (e.g. `"en-US"`, `"de"`, `"ja"`).
+     * Defaults to `document.documentElement.lang`, then `navigator.language`.
+     * @attr lang
+     */
+    lang: string;
+    /**
+     * Month display format.
+     * @attr month
+     */
+    month: 'narrow' | 'short' | 'long' | 'numeric' | '2-digit' | undefined;
+    /**
+     * Year display format.
+     * @attr year
+     */
+    year: 'numeric' | '2-digit' | undefined;
+    /**
+     * Day display format.
+     * @attr day
+     */
+    day: 'numeric' | '2-digit' | undefined;
+    /**
+     * Weekday display format.
+     * @attr weekday
+     */
+    weekday: 'narrow' | 'short' | 'long' | undefined;
+    /**
+     * Hour display format.
+     * @attr hour
+     */
+    hour: 'numeric' | '2-digit' | undefined;
+    /**
+     * Minute display format.
+     * @attr minute
+     */
+    minute: 'numeric' | '2-digit' | undefined;
+    /**
+     * Second display format.
+     * @attr second
+     */
+    second: 'numeric' | '2-digit' | undefined;
+    /**
+     * Time zone name display format. Accepts all values supported by
+     * `Intl.DateTimeFormatOptions.timeZoneName` including `'short'`, `'long'`,
+     * `'shortOffset'`, `'longOffset'`, `'shortGeneric'`, and `'longGeneric'`.
+     * @attr time-zone-name
+     */
+    timeZoneName: Intl.DateTimeFormatOptions['timeZoneName'];
+    /**
+     * IANA time zone identifier (e.g. `"America/New_York"`, `"UTC"`).
+     * @attr time-zone
+     */
+    timeZone: string | undefined;
+    /**
+     * Whether to use 12-hour or 24-hour clock. `"auto"` defers to locale default.
+     * @attr hour-format
+     */
+    hourFormat: 'auto' | '12' | '24';
+    /**
+     * Controls whether `Intl.RelativeTimeFormat` always shows numeric output
+     * (`"always"`) or uses natural language when possible (`"auto"`, e.g. "yesterday").
+     * Only used when `relative` is true.
+     * @attr numeric
+     */
+    numeric: 'always' | 'auto';
+    /**
+     * When true, displays a relative time string such as "2 hours ago" or "in 3 days"
+     * using `Intl.RelativeTimeFormat`.
+     *
+     * **Important:** The relative time string is computed once at render time and does
+     * not auto-update. If the displayed text must stay current (e.g. a live "X minutes
+     * ago" counter), the consuming component must re-set the `date` property on its own
+     * interval to trigger a re-render.
+     * @attr relative
+     */
+    relative: boolean;
+    private _getDate;
+    private _getLocale;
+    private _getHour12;
+    /**
+     * Returns the `datetime` attribute value. When `timeZone` is set, returns a
+     * timezone-offset ISO string (e.g. `2024-09-20T05:00:00-04:00`) so that
+     * assistive technology reads the same local time as the visual display.
+     */
+    private _getDatetimeAttr;
+    private _formatRelative;
+    private _formatAbsolute;
+    render(): import('lit-html').TemplateResult<1>;
+}
+export type HxFormatDate = HelixFormatDate;
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-format-date': HelixFormatDate;
+    }
+}
+//# sourceMappingURL=hx-format-date.d.ts.map

package/dist/components/hx-format-date/hx-format-date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-format-date.d.ts","sourceRoot":"","sources":["../../../src/components/hx-format-date/hx-format-date.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAKvC;;;;;;;;;;;;GAYG;AACH,qBACa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,MAAM,4BAAwC;IAG9D,OAAO,CAAC,MAAM,CAAC,SAAS,CAA0C;IAClE,OAAO,CAAC,MAAM,CAAC,SAAS,CAA8C;IAEtE;;;;OAIG;IAEH,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAM;IAElC;;;;OAIG;IAEM,IAAI,SAAM;IAEnB;;;OAGG;IAEH,KAAK,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEnF;;;OAGG;IAEH,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEpD;;;OAGG;IAEH,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEnD;;;OAGG;IAEH,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAa;IAE7D;;;OAGG;IAEH,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEpD;;;OAGG;IAEH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEtD;;;OAGG;IAEH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAa;IAEtD;;;;;OAKG;IAEH,YAAY,EAAE,IAAI,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAa;IAErE;;;OAGG;IAEH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IAEzC;;;OAGG;IAEH,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAU;IAE1C;;;;;OAKG;IAEH,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAU;IAEpC;;;;;;;;;OASG;IAEH,QAAQ,UAAS;IAIjB,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,eAAe;IA6Cd,MAAM;CAOhB;AAED,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC;AAE3C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,eAAe,CAAC;KACnC;CACF"}

package/dist/components/hx-format-date/hx-format-date.styles.d.ts

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

package/dist/components/hx-format-date/hx-format-date.styles.d.ts.map

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

package/dist/components/hx-format-date/index.d.ts

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

package/dist/components/hx-format-date/index.d.ts.map

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

package/dist/components/hx-format-date/index.js

@@ -0,0 +1,5 @@
+import { H as o } from "../../shared/hx-format-date-BIR66MeC.js";
+export {
+  o as HelixFormatDate
+};
+//# sourceMappingURL=index.js.map

package/dist/components/hx-format-date/index.js.map

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

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

@@ -0,0 +1,100 @@
+import { LitElement } from 'lit';
+type GapSize = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+type AlignValue = 'start' | 'center' | 'end' | 'stretch';
+type JustifyValue = 'start' | 'center' | 'end' | 'stretch';
+/**
+ * A CSS Grid layout wrapper with design-token-based column and gap system.
+ *
+ * @summary CSS Grid layout primitive for building responsive grid layouts.
+ *
+ * @tag hx-grid
+ *
+ * @slot - Default slot for grid content (use `hx-grid-item` for precise placement).
+ *
+ * @csspart base - The grid container element.
+ *
+ * @cssprop [--hx-grid-columns] - Override the computed grid-template-columns.
+ * @cssprop [--hx-grid-gap] - Override the computed gap.
+ * @cssprop [--hx-grid-row-gap] - Override the computed row-gap.
+ * @cssprop [--hx-grid-column-gap] - Override the computed column-gap.
+ */
+export declare class HelixGrid extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * Number of equal columns (`repeat(N, 1fr)`) or a CSS grid-template-columns string.
+     * @attr columns
+     */
+    columns: number | string;
+    /**
+     * Gap size applied to both row and column gaps.
+     * @attr gap
+     */
+    gap: GapSize;
+    /**
+     * Row gap override. When set, takes precedence over `gap` for row spacing.
+     * @attr row-gap
+     */
+    rowGap: GapSize | undefined;
+    /**
+     * Column gap override. When set, takes precedence over `gap` for column spacing.
+     * @attr column-gap
+     */
+    columnGap: GapSize | undefined;
+    /**
+     * Aligns grid items along the block axis (align-items).
+     * @attr align
+     */
+    align: AlignValue;
+    /**
+     * Justifies grid items along the inline axis (justify-items).
+     * @attr justify
+     */
+    justify: JustifyValue;
+    private _gridTemplateColumns;
+    private _resolveGap;
+    private _computedRowGap;
+    private _computedColumnGap;
+    private _baseStyle;
+    render(): import('lit-html').TemplateResult<1>;
+}
+/**
+ * Optional companion element for precise grid item placement.
+ * Applies grid-column and grid-row directly to the host element
+ * so it participates correctly in the parent CSS grid layout.
+ *
+ * @summary Grid item with explicit column/row placement.
+ *
+ * @tag hx-grid-item
+ *
+ * @slot - Default slot for item content.
+ */
+export declare class HelixGridItem extends LitElement {
+    static styles: import('lit').CSSResult[];
+    /**
+     * CSS grid-column value (e.g., "1 / 3", "span 2").
+     * @attr column
+     */
+    column: string | undefined;
+    /**
+     * CSS grid-row value (e.g., "1 / 2").
+     * @attr row
+     */
+    row: string | undefined;
+    /**
+     * Column span shorthand — equivalent to setting `column: "span N"`.
+     * @attr span
+     */
+    span: number | undefined;
+    updated(changed: Map<string, unknown>): void;
+    connectedCallback(): void;
+    private _applyHostGridStyles;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'hx-grid': HelixGrid;
+        'hx-grid-item': HelixGridItem;
+    }
+}
+export {};
+//# sourceMappingURL=hx-grid.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hx-grid.d.ts","sourceRoot":"","sources":["../../../src/components/hx-grid/hx-grid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAQ,MAAM,KAAK,CAAC;AAKvC,KAAK,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,KAAK,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AACzD,KAAK,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAW3D;;;;;;;;;;;;;;;GAeG;AACH,qBACa,SAAU,SAAQ,UAAU;IACvC,OAAgB,MAAM,4BAAkC;IAExD;;;OAGG;IAEH,OAAO,EAAE,MAAM,GAAG,MAAM,CAAK;IAE7B;;;OAGG;IAEH,GAAG,EAAE,OAAO,CAAQ;IAEpB;;;OAGG;IAEH,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAE5B;;;OAGG;IAEH,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B;;;OAGG;IAEH,KAAK,EAAE,UAAU,CAAa;IAE9B;;;OAGG;IAEH,OAAO,EAAE,YAAY,CAAa;IAElC,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,UAAU;IAWT,MAAM;CAOhB;AAED;;;;;;;;;;GAUG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAAsC;IAE5D;;;OAGG;IAEH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;OAGG;IAEH,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAExB;;;OAGG;IAEH,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5C,iBAAiB,IAAI,IAAI;IAKlC,OAAO,CAAC,oBAAoB;IAenB,MAAM;CAGhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,SAAS,EAAE,SAAS,CAAC;QACrB,cAAc,EAAE,aAAa,CAAC;KAC/B;CACF"}

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

@@ -0,0 +1,3 @@
+export declare const helixGridStyles: import('lit').CSSResult;
+export declare const helixGridItemStyles: import('lit').CSSResult;
+//# sourceMappingURL=hx-grid.styles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hx-grid.styles.d.ts","sourceRoot":"","sources":["../../../src/components/hx-grid/hx-grid.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,yBAM3B,CAAC;AAEF,eAAO,MAAM,mBAAmB,yBAM/B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,6 @@
+import { H as r, a } from "../../shared/hx-grid-Dgo7fnWu.js";
+export {
+  r as HelixGrid,
+  a as HelixGridItem
+};
+//# sourceMappingURL=index.js.map

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

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