@openvoxproject/voxblocks 0.9.0

package/dist/types/components/accordion/vox-accordion.d.ts

@@ -0,0 +1,32 @@
+import { LitElement } from 'lit';
+/**
+ * A stack of expandable panels.
+ *
+ * @slot - `<vox-accordion-item>` elements.
+ */
+export declare class VoxAccordion extends LitElement {
+    /** Allow only one panel open at a time. */
+    single: boolean;
+    static styles: import("lit").CSSResult;
+    private handleToggle;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/**
+ * One panel of a `<vox-accordion>`.
+ *
+ * @slot - Panel content.
+ * @fires vox-toggle - When the panel opens or closes.
+ */
+export declare class VoxAccordionItem extends LitElement {
+    heading: string;
+    open: boolean;
+    static styles: import("lit").CSSResult;
+    toggle(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-accordion': VoxAccordion;
+        'vox-accordion-item': VoxAccordionItem;
+    }
+}

package/dist/types/components/alert/vox-alert.d.ts

@@ -0,0 +1,23 @@
+import { LitElement } from 'lit';
+export type AlertVariant = 'info' | 'success' | 'warning' | 'danger';
+/**
+ * A page-level notification message, optionally dismissible.
+ * For static advisory text inside prose, see `<vox-callout>`.
+ *
+ * @slot - Alert message.
+ * @fires vox-dismiss - When the user dismisses the alert.
+ */
+export declare class VoxAlert extends LitElement {
+    variant: AlertVariant;
+    heading: string;
+    dismissible: boolean;
+    open: boolean;
+    static styles: import("lit").CSSResult;
+    dismiss(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-alert': VoxAlert;
+    }
+}

package/dist/types/components/avatar/vox-avatar.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from 'lit';
+export type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * A circular avatar showing an image, or initials as a fallback.
+ */
+export declare class VoxAvatar extends LitElement {
+    src?: string;
+    alt: string;
+    initials: string;
+    size: AvatarSize;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-avatar': VoxAvatar;
+    }
+}

package/dist/types/components/badge/vox-badge.d.ts

@@ -0,0 +1,17 @@
+import { LitElement } from 'lit';
+export type BadgeVariant = 'brand' | 'tip' | 'warning' | 'danger' | 'neutral';
+/**
+ * A small status pill, e.g. for version labels or deprecation notices.
+ *
+ * @slot - Badge label.
+ */
+export declare class VoxBadge extends LitElement {
+    variant: BadgeVariant;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-badge': VoxBadge;
+    }
+}

package/dist/types/components/billboard/vox-billboard.d.ts

@@ -0,0 +1,22 @@
+import { LitElement } from 'lit';
+/**
+ * A split media-and-content section for landing pages.
+ *
+ * @slot media - Image or other media shown beside the content.
+ * @slot - Body content.
+ * @slot actions - Buttons or CTA links below the body.
+ */
+export declare class VoxBillboard extends LitElement {
+    heading: string;
+    /** Put the media on the right instead of the left. */
+    reverse: boolean;
+    static styles: import("lit").CSSResult;
+    private hasActions;
+    private handleActionsSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-billboard': VoxBillboard;
+    }
+}

package/dist/types/components/breadcrumbs/vox-breadcrumbs.d.ts

@@ -0,0 +1,24 @@
+import { LitElement } from 'lit';
+/**
+ * A breadcrumb trail. Children are plain links, with the current page
+ * as a `<span aria-current="page">`:
+ *
+ * ```html
+ * <vox-breadcrumbs>
+ *   <a href="/">Home</a>
+ *   <a href="/modules">Modules</a>
+ *   <span aria-current="page">puppet-nginx</span>
+ * </vox-breadcrumbs>
+ * ```
+ *
+ * @slot - Links and the current-page span.
+ */
+export declare class VoxBreadcrumbs extends LitElement {
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-breadcrumbs': VoxBreadcrumbs;
+    }
+}

package/dist/types/components/button/vox-button.d.ts

@@ -0,0 +1,24 @@
+import { LitElement } from 'lit';
+export type ButtonVariant = 'brand' | 'alt' | 'danger' | 'ghost';
+export type ButtonSize = 'sm' | 'md' | 'lg';
+/**
+ * A button styled after the OpenVox docs action buttons.
+ * Renders an anchor when `href` is set, a real button otherwise.
+ *
+ * @slot - Button label.
+ */
+export declare class VoxButton extends LitElement {
+    variant: ButtonVariant;
+    size: ButtonSize;
+    href?: string;
+    target?: string;
+    type: 'button' | 'submit' | 'reset';
+    disabled: boolean;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-button': VoxButton;
+    }
+}

package/dist/types/components/calendar-tile/vox-calendar-tile.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from 'lit';
+/**
+ * A compact date tile for event listings. Give it an ISO date
+ * (`date="2026-09-18"`); month and day render localized.
+ */
+export declare class VoxCalendarTile extends LitElement {
+    /** ISO date string, e.g. "2026-09-18". */
+    date: string;
+    /** BCP 47 locale for month formatting; defaults to the page locale. */
+    locale?: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-calendar-tile': VoxCalendarTile;
+    }
+}

package/dist/types/components/callout/vox-callout.d.ts

@@ -0,0 +1,20 @@
+import { LitElement } from 'lit';
+export type CalloutVariant = 'info' | 'tip' | 'warning' | 'danger';
+/**
+ * An admonition block matching the custom containers on the OpenVox docs
+ * (::: tip, ::: warning, ...).
+ *
+ * @slot - Callout body content.
+ */
+export declare class VoxCallout extends LitElement {
+    variant: CalloutVariant;
+    /** Heading text; defaults to the capitalized variant name. */
+    heading?: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-callout': VoxCallout;
+    }
+}

package/dist/types/components/card/vox-card.d.ts

@@ -0,0 +1,28 @@
+import { LitElement } from 'lit';
+/**
+ * A feature card in the style of the OpenVox docs landing page tiles.
+ * Becomes a single large link when `href` is set.
+ *
+ * @slot icon - Optional icon or emoji shown above the heading.
+ * @slot badge - Optional badge or label shown in the top-right corner.
+ * @slot - Card body text.
+ * @slot footer - Optional content pinned to the bottom of the card, e.g. stats.
+ */
+export declare class VoxCard extends LitElement {
+    heading: string;
+    href?: string;
+    target?: string;
+    static styles: import("lit").CSSResult;
+    private hasIcon;
+    private hasBadge;
+    private hasFooter;
+    private handleIconSlotChange;
+    private handleBadgeSlotChange;
+    private handleFooterSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-card': VoxCard;
+    }
+}

package/dist/types/components/checkbox/vox-checkbox.d.ts

@@ -0,0 +1,20 @@
+import { VoxFieldElement } from '../../internal/field.js';
+/**
+ * A checkbox with a custom visual that follows the VoxBlocks theme.
+ *
+ * @slot - Checkbox label.
+ */
+export declare class VoxCheckbox extends VoxFieldElement {
+    checked: boolean;
+    value: string;
+    static styles: import("lit").CSSResult[];
+    formResetCallback(): void;
+    updated(): void;
+    private handleChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-checkbox': VoxCheckbox;
+    }
+}

package/dist/types/components/cta/vox-cta.d.ts

@@ -0,0 +1,17 @@
+import { LitElement } from 'lit';
+/**
+ * A call-to-action link with a trailing arrow that nudges on hover.
+ *
+ * @slot - Link text.
+ */
+export declare class VoxCta extends LitElement {
+    href: string;
+    target?: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-cta': VoxCta;
+    }
+}

package/dist/types/components/cta-band/vox-cta-band.d.ts

@@ -0,0 +1,22 @@
+import { LitElement } from 'lit';
+/**
+ * A centered, full-width call-to-action panel: heading, supporting copy,
+ * and a row of buttons — the closing pitch at the bottom of a page.
+ *
+ * @slot - Supporting copy under the heading.
+ * @slot actions - Buttons or CTA links.
+ */
+export declare class VoxCtaBand extends LitElement {
+    heading: string;
+    static styles: import("lit").CSSResult;
+    private hasBody;
+    private hasActions;
+    private handleBodySlotChange;
+    private handleActionsSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-cta-band': VoxCtaBand;
+    }
+}

package/dist/types/components/dialog/vox-dialog.d.ts

@@ -0,0 +1,30 @@
+import { LitElement } from 'lit';
+/**
+ * A modal dialog built on the native `<dialog>` element, which provides
+ * focus trapping and Escape-to-close for free.
+ *
+ * @slot - Dialog body.
+ * @slot footer - Action buttons.
+ * @fires vox-close - When the dialog closes.
+ */
+export declare class VoxDialog extends LitElement {
+    heading: string;
+    open: boolean;
+    /** Close when the backdrop is clicked. */
+    lightDismiss: boolean;
+    private dialogEl;
+    static styles: import("lit").CSSResult;
+    private hasFooter;
+    show(): void;
+    close(): void;
+    updated(): void;
+    private handleNativeClose;
+    private handleClick;
+    private handleFooterSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-dialog': VoxDialog;
+    }
+}

package/dist/types/components/disclosure/vox-disclosure.d.ts

@@ -0,0 +1,19 @@
+import { LitElement } from 'lit';
+/**
+ * A single show/hide toggle for supplementary content.
+ *
+ * @slot - Hidden content.
+ * @fires vox-toggle - When the content is shown or hidden.
+ */
+export declare class VoxDisclosure extends LitElement {
+    summary: string;
+    open: boolean;
+    static styles: import("lit").CSSResult;
+    toggle(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-disclosure': VoxDisclosure;
+    }
+}

package/dist/types/components/dropdown/vox-dropdown.d.ts

@@ -0,0 +1,29 @@
+import { LitElement } from 'lit';
+/**
+ * A menu button. Menu entries are light-DOM `<a>` or `<button>` children:
+ *
+ * ```html
+ * <vox-dropdown label="Resources">
+ *   <a href="/docs">Documentation</a>
+ *   <button type="button">Copy install command</button>
+ * </vox-dropdown>
+ * ```
+ *
+ * @slot - Menu entries (`<a>`, `<button>`, `<hr>` for separators).
+ */
+export declare class VoxDropdown extends LitElement {
+    label: string;
+    open: boolean;
+    static styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleOutsideClick;
+    private handleKeydown;
+    private toggle;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-dropdown': VoxDropdown;
+    }
+}

package/dist/types/components/empty-state/vox-empty-state.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from 'lit';
+/**
+ * A placeholder for views with nothing to show yet.
+ *
+ * @slot icon - Icon or emoji above the heading.
+ * @slot - Explanatory text.
+ * @slot actions - Buttons or links suggesting a next step.
+ */
+export declare class VoxEmptyState extends LitElement {
+    heading: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-empty-state': VoxEmptyState;
+    }
+}

package/dist/types/components/file-input/vox-file-input.d.ts

@@ -0,0 +1,22 @@
+import { VoxFieldElement } from '../../internal/field.js';
+/**
+ * A file picker: a themed button backed by a native file input,
+ * showing the selected file name(s).
+ */
+export declare class VoxFileInput extends VoxFieldElement {
+    accept?: string;
+    multiple: boolean;
+    /** Label on the picker button. */
+    buttonLabel: string;
+    private fileNames;
+    private inputEl;
+    static styles: import("lit").CSSResult[];
+    formResetCallback(): void;
+    private handleChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-file-input': VoxFileInput;
+    }
+}

package/dist/types/components/footer/vox-footer.d.ts

@@ -0,0 +1,28 @@
+import { LitElement } from 'lit';
+/**
+ * A site footer. The default slot holds link columns
+ * (`<vox-footer-column>`), the `bottom` slot holds copyright text.
+ *
+ * @slot - `<vox-footer-column>` elements.
+ * @slot bottom - Copyright / legal line.
+ */
+export declare class VoxFooter extends LitElement {
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/**
+ * One column of footer links.
+ *
+ * @slot - `<a>` elements.
+ */
+export declare class VoxFooterColumn extends LitElement {
+    heading: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-footer': VoxFooter;
+        'vox-footer-column': VoxFooterColumn;
+    }
+}

package/dist/types/components/grid/vox-grid.d.ts

@@ -0,0 +1,22 @@
+import { LitElement } from 'lit';
+/**
+ * A responsive CSS grid container. By default columns auto-fit to the
+ * `min` track width; set `cols` for a fixed column count.
+ *
+ * @slot - Grid items.
+ */
+export declare class VoxGrid extends LitElement {
+    /** Fixed number of columns; 0 means auto-fit. */
+    cols: number;
+    /** Minimum column width used when auto-fitting. */
+    min: string;
+    gap: 'sm' | 'md' | 'lg';
+    static styles: import("lit").CSSResult;
+    updated(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-grid': VoxGrid;
+    }
+}

package/dist/types/components/header/vox-header.d.ts

@@ -0,0 +1,23 @@
+import { LitElement } from 'lit';
+/**
+ * A site header with brand, primary navigation, and an actions area.
+ * Nav entries are plain links; mark the current page with
+ * `aria-current="page"`.
+ *
+ * @slot logo - Brand mark shown before the site title.
+ * @slot - Navigation links.
+ * @slot actions - Right-aligned extras (buttons, theme toggle, ...).
+ */
+export declare class VoxHeader extends LitElement {
+    /** Site title shown next to the logo. */
+    siteTitle: string;
+    /** Where the brand links to. */
+    href: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-header': VoxHeader;
+    }
+}

package/dist/types/components/hero/vox-hero.d.ts

@@ -0,0 +1,21 @@
+import { LitElement } from 'lit';
+/**
+ * A page-title header section.
+ *
+ * @slot - Intro text under the heading.
+ * @slot actions - Buttons or CTA links.
+ */
+export declare class VoxHero extends LitElement {
+    /** Small label displayed above the heading. */
+    eyebrow: string;
+    heading: string;
+    static styles: import("lit").CSSResult;
+    private hasActions;
+    private handleActionsSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-hero': VoxHero;
+    }
+}

package/dist/types/components/input/vox-input.d.ts

@@ -0,0 +1,24 @@
+import { VoxFieldElement } from '../../internal/field.js';
+/**
+ * A single-line text input with label and help note.
+ * Participates in native form submission via ElementInternals.
+ */
+export declare class VoxInput extends VoxFieldElement {
+    type: string;
+    value: string;
+    placeholder?: string;
+    autocomplete?: string;
+    readonly: boolean;
+    static styles: import("lit").CSSResult;
+    formResetCallback(): void;
+    updated(): void;
+    focus(options?: FocusOptions): void;
+    private handleInput;
+    private handleChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-input': VoxInput;
+    }
+}

package/dist/types/components/input-group/vox-input-group.d.ts

@@ -0,0 +1,25 @@
+import { LitElement } from 'lit';
+/**
+ * Joins inputs, selects, buttons, and text segments into one attached row:
+ *
+ * ```html
+ * <vox-input-group>
+ *   <vox-input aria-label="Search modules"></vox-input>
+ *   <vox-button>Search</vox-button>
+ * </vox-input-group>
+ * ```
+ *
+ * The group marks each child with a `data-vox-group` position attribute
+ * (`start` / `middle` / `end`); VoxBlocks controls flatten their inner
+ * corners accordingly. Plain `<span>` children render as text addons.
+ */
+export declare class VoxInputGroup extends LitElement {
+    static styles: import("lit").CSSResult;
+    private handleSlotChange;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-input-group': VoxInputGroup;
+    }
+}

package/dist/types/components/link-hub/vox-link-hub.d.ts

@@ -0,0 +1,27 @@
+import { LitElement } from 'lit';
+/**
+ * A grid of prominent links with descriptions, for hub/landing pages.
+ *
+ * @slot - `<vox-link-hub-item>` elements.
+ */
+export declare class VoxLinkHub extends LitElement {
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/**
+ * One link in a `<vox-link-hub>`.
+ *
+ * @slot - Short description under the link title.
+ */
+export declare class VoxLinkHubItem extends LitElement {
+    href: string;
+    heading: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-link-hub': VoxLinkHub;
+        'vox-link-hub-item': VoxLinkHubItem;
+    }
+}

package/dist/types/components/loader/vox-loader.d.ts

@@ -0,0 +1,16 @@
+import { LitElement } from 'lit';
+export type LoaderSize = 'sm' | 'md' | 'lg';
+/**
+ * A loading spinner. The `label` is announced to screen readers.
+ */
+export declare class VoxLoader extends LitElement {
+    size: LoaderSize;
+    label: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-loader': VoxLoader;
+    }
+}

package/dist/types/components/pagination/vox-pagination.d.ts

@@ -0,0 +1,25 @@
+import { LitElement } from 'lit';
+/**
+ * Page-number navigation. Children are plain links; mark the current
+ * page with `aria-current="page"`:
+ *
+ * ```html
+ * <vox-pagination>
+ *   <a href="?page=1">1</a>
+ *   <a href="?page=2" aria-current="page">2</a>
+ *   <a href="?page=3">3</a>
+ * </vox-pagination>
+ * ```
+ *
+ * @slot - `<a>` elements (including any prev/next links).
+ */
+export declare class VoxPagination extends LitElement {
+    label: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-pagination': VoxPagination;
+    }
+}

package/dist/types/components/quote/vox-quote.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from 'lit';
+/**
+ * A pull quote with optional attribution.
+ *
+ * @slot - Quote text.
+ */
+export declare class VoxQuote extends LitElement {
+    attribution: string;
+    /** Additional context under the attribution, e.g. a role or company. */
+    detail: string;
+    static styles: import("lit").CSSResult;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'vox-quote': VoxQuote;
+    }
+}