npm - @peektravel/app-utilities - Versions diffs - 0.1.1 → 0.1.2 - Mend

@peektravel/app-utilities 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

package/dist/ui/index.d.ts ADDED Viewed

@@ -0,0 +1,1479 @@
+/**
+ * Localization for the Odyssey Web Components' **built-in** strings (aria-labels,
+ * default placeholders, status labels — not consumer-provided content).
+ *
+ * The active language is resolved from the DOM: a component reads the closest
+ * ancestor `lang` attribute (so `<html lang="es">` localizes everything), with
+ * fallback to English. Consumers register term bundles once:
+ *
+ * ```ts
+ * import { registerTranslation } from '@peektravel/app-utilities/ui';
+ * registerTranslation('es', { close: 'Cerrar', clear: 'Borrar', search: 'Buscar' });
+ * ```
+ *
+ * A single instance can still be overridden with a per-instance attribute
+ * (e.g. `<ody-panel close-label="Cerrar">`), which wins over the registry.
+ */
+/** The full set of built-in term keys. Bundles may provide any subset. */
+interface OdyTerms {
+    close: string;
+    clear: string;
+    search: string;
+    noOptions: string;
+    previousMonth: string;
+    nextMonth: string;
+    selectDate: string;
+    openSubMenu: string;
+    toggleMenu: string;
+    breadcrumb: string;
+    radioGroup: string;
+    toggleGroup: string;
+    checkInInProgress: string;
+    checkInNoShow: string;
+    checkInOverdue: string;
+    checkInReserved: string;
+    checkInReturned: string;
+    checkInNone: string;
+}
+type OdyTermKey = keyof OdyTerms;
+/**
+ * Register (or extend) a translation bundle for a BCP-47 language code
+ * (e.g. `'es'`, `'fr-CA'`). Re-registering merges into the existing bundle and
+ * triggers a re-render of mounted components.
+ */
+declare function registerTranslation(lang: string, terms: Partial<OdyTerms>): void;
+/**
+ * Shared base class and helpers for the Odyssey Web Components.
+ *
+ * The components render into the **light DOM** (no Shadow DOM) on purpose: the
+ * shipped `odyssey.css` global classes then style them exactly as the Ember
+ * addon does, and consuming apps can override with the same selectors. The base
+ * handles the common plumbing — re-rendering when an observed attribute
+ * changes, and preserving consumer-provided child content ("slotted" nodes)
+ * across those re-renders.
+ *
+ * It also localizes **built-in** strings: {@link term} resolves a term for the
+ * element's language (the nearest `lang` ancestor), and components re-render
+ * automatically when the language or a registered bundle changes.
+ */
+declare abstract class OdyElement extends HTMLElement {
+    #private;
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    /** Build the component's inner markup; implementations call {@link mount}. */
+    protected abstract render(): void;
+    /**
+     * Replace the element's inner markup with `chrome`, then re-insert any
+     * consumer-provided child nodes into the placeholder element marked with a
+     * `data-ody-slot` attribute (if the chrome declares one). Idempotent — safe
+     * to call on every attribute change without losing the original children.
+     */
+    protected mount(chrome: string): void;
+    /** Read a string attribute with a fallback. */
+    protected attr(name: string, fallback?: string): string;
+    /** Whether a boolean attribute is present and not explicitly `"false"`. */
+    protected flag(name: string): boolean;
+    /** Escape a string for safe interpolation into chrome markup. */
+    protected esc(value: string): string;
+    /** Translate a built-in term key for this element's resolved language. */
+    protected term(key: OdyTermKey): string;
+    /**
+     * A per-instance attribute override (e.g. `close-label`) when present,
+     * otherwise the localized built-in term. Result is HTML-escaped for safe
+     * interpolation into chrome (e.g. inside an `aria-label="…"`).
+     */
+    protected localized(attrName: string, key: OdyTermKey): string;
+    disconnectedCallback(): void;
+}
+/** HTML-escape a string (ampersand, angle brackets, quotes). */
+declare function escapeHtml(value: string): string;
+/**
+ * Join class-name fragments, dropping falsy entries. Keeps component templates
+ * readable when classes are conditional.
+ */
+declare function classes(...parts: Array<string | false | null | undefined>): string;
+/**
+ * Register a custom element under `tag`, guarding against double registration
+ * (and against running in a non-DOM environment such as a Node import).
+ */
+declare function define(tag: string, ctor: CustomElementConstructor): void;
+type OdyIconSize = 'extra-small' | 'mid-small' | 'small' | 'base' | 'medium' | 'large' | 'free';
+/**
+ * `<ody-icon>` — renders a named inline SVG from the bundled icon set.
+ *
+ * Attributes:
+ * - `name` — icon name (see `icons.ts`); unknown names render nothing.
+ * - `size` — one of {@link OdyIconSize} (default `base`).
+ * - `disabled` — dims the icon.
+ */
+declare class OdyIcon extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdyButtonVariant = 'primary' | 'secondary' | 'ghost' | 'tertiary' | 'danger';
+type OdyButtonAppearance = 'success' | 'interaction' | 'danger' | 'grey';
+type OdyButtonSize = 'base' | 'small';
+/**
+ * `<ody-button>` — the Odyssey button. The text label is the element's child
+ * content; icons and state are driven by attributes.
+ *
+ * Attributes:
+ * - `variant` — `primary` | `secondary` | `ghost` | `tertiary` | `danger` (default `primary`).
+ * - `appearance` — colour intent `interaction` | `success` | `danger` | `grey` (default `interaction`).
+ * - `size` — `base` | `small` (default `base`).
+ * - `type` — native button type `button` | `submit` (default `button`).
+ * - `left-icon` / `right-icon` — named icons placed beside the label.
+ * - `loading`, `icon-only`, `active`, `disabled`, `icon-rotate` — boolean flags.
+ */
+declare class OdyButton extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdyTagVariant = 'primary' | 'secondary';
+type OdyTagColor = 'default' | 'info' | 'success' | 'warning' | 'danger' | 'teal' | 'lime' | 'purple' | 'pink' | 'turquoise' | 'yellow' | 'orange' | 'rose' | 'blue';
+type OdyTagSize = 'base' | 'small';
+/**
+ * `<ody-tag>` — a rounded label/pill. Label text is the element's child content.
+ *
+ * Attributes:
+ * - `variant` — `primary` (filled) | `secondary` (outline) (default `primary`).
+ * - `color` — semantic/accent colour (default `default`).
+ * - `size` — `base` | `small` (default `base`).
+ * - `icon` — optional leading icon name.
+ * - `count` — optional trailing count.
+ */
+declare class OdyTag extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdyAlertVariant = 'info' | 'success' | 'warning' | 'danger';
+/**
+ * `<ody-alert>` — a contextual message box. The body is the element's child
+ * content; the bold heading line is set via the `heading` attribute.
+ *
+ * Attributes:
+ * - `variant` — `info` | `success` | `warning` | `danger` (default `info`).
+ * - `heading` — optional bold message shown beside the icon.
+ */
+declare class OdyAlert extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-card>` — a bordered content container with an accent bar on the left.
+ * Card content is the element's child content.
+ *
+ * Attributes:
+ * - `bar-color` — CSS colour for the accent bar (default neutral-200).
+ * - `clickable` — adds pointer affordance (emit your own click handling).
+ */
+declare class OdyCard extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/** `<ody-divider>` — a 1px horizontal rule that fills its container width. */
+declare class OdyDivider extends OdyElement {
+    protected render(): void;
+}
+type OdyStatusDotColor = 'green' | 'blue' | 'orange';
+/**
+ * `<ody-status-dot>` — a coloured dot with a label. Label is the child content.
+ *
+ * Attributes:
+ * - `color` — `green` | `blue` | `orange` (default `green`).
+ */
+declare class OdyStatusDot extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-message>` — a small inline status message with an optional leading
+ * icon. Message text is the element's child content.
+ *
+ * Attributes:
+ * - `icon` — optional leading icon name.
+ */
+declare class OdyMessage extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdySpinnerSize = 'small' | 'base' | 'large';
+/**
+ * `<ody-loading-spinner>` — an animated spinner with an optional label
+ * (the element's child content).
+ *
+ * Attributes:
+ * - `size` — `small` | `base` | `large` (default `base`).
+ */
+declare class OdyLoadingSpinner extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-loading-bar>` — a horizontal progress bar.
+ *
+ * Attributes:
+ * - `value` — fill percentage, clamped to 0–100 (default 0).
+ * - `color` — CSS colour for the fill (default interaction-300).
+ * - `label` — optional caption shown above the bar with the percentage.
+ */
+declare class OdyLoadingBar extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * Built-in empty-state variants. Each maps to a default icon when no explicit
+ * `icon`/`img-src` is supplied — mirroring the Odyssey `empty-state-*` SVGs.
+ */
+type OdyEmptyStateVariant = 'default' | 'error' | 'no-results' | 'no-search' | 'not-authorized';
+/**
+ * `<ody-empty-state>` — a centred placeholder for empty/error/no-results views.
+ * The element's child content is rendered below the label/caption (e.g. an
+ * action button).
+ *
+ * Attributes:
+ * - `variant` — `default` | `error` | `no-results` | `no-search` | `not-authorized`
+ *   (default `default`); selects a fallback illustration icon.
+ * - `img-src` / `img-alt` — render a custom image instead of the icon.
+ * - `icon` — override the illustration with a named icon.
+ * - `label` — bold primary message.
+ * - `caption` — secondary message.
+ */
+declare class OdyEmptyState extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-breadcrumb>` — a breadcrumb trail. Compose with nested
+ * `<ody-breadcrumb-item>` children; the wrapper renders the
+ * `<nav><ol>` chrome and the items render the `<li>` rows.
+ *
+ * Example:
+ * ```html
+ * <ody-breadcrumb>
+ *   <ody-breadcrumb-item><a href="/">Home</a></ody-breadcrumb-item>
+ *   <ody-breadcrumb-item current>Details</ody-breadcrumb-item>
+ * </ody-breadcrumb>
+ * ```
+ */
+declare class OdyBreadcrumb extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-breadcrumb-item>` — a single crumb. Label/link is the child content.
+ *
+ * Attributes:
+ * - `current` — marks the active page (`aria-current="page"` + active style).
+ */
+declare class OdyBreadcrumbItem extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/** Colour tone for a stat's value. */
+type OdyStatTone = 'default' | 'success' | 'warning';
+/**
+ * `<ody-stat-summary>` — a bordered card grouping a row of `<ody-stat>` figures.
+ * For the optional detail strip, render an `<ody-stat-summary-detail>` as a
+ * sibling immediately after it (see that component).
+ *
+ * Simplest usage — stats only:
+ * ```html
+ * <ody-stat-summary>
+ *   <ody-stat label="Revenue" value="$1,200"></ody-stat>
+ *   <ody-stat label="Bookings" value="34" tone="success"></ody-stat>
+ * </ody-stat-summary>
+ * ```
+ */
+declare class OdyStatSummary extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-stat>` — a single labelled figure inside an `<ody-stat-summary>`.
+ *
+ * Attributes:
+ * - `label` — caption above the value.
+ * - `value` — the prominent figure (falls back to child content if omitted).
+ * - `sub` — small sub-text below the value.
+ * - `tone` — `default` | `success` | `warning` (colours the value).
+ */
+declare class OdyStat extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-stat-detail>` — a small key/value pair for the detail strip beneath a
+ * stat summary. Place inside an `<ody-stat-summary-detail>` group.
+ *
+ * Attributes:
+ * - `value` — the bold value text appended after the label (child content).
+ */
+declare class OdyStatDetail extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-stat-summary-detail>` — the optional detail strip rendered under a
+ * `<ody-stat-summary>` (divider + a row of `<ody-stat-detail>` items). Place it
+ * as a sibling after the stat summary.
+ */
+declare class OdyStatSummaryDetail extends OdyElement {
+    protected render(): void;
+}
+type OdyInlineListSeparator = 'line' | 'bullet';
+/**
+ * `<ody-inline-list>` — a horizontal list whose items are separated by a thin
+ * rule or a bullet. Compose with nested `<ody-inline-list-item>` children.
+ *
+ * Attributes:
+ * - `separator` — `line` | `bullet` (default `line`).
+ * - `gap` — spacing in px between items (default `12`).
+ *
+ * Example:
+ * ```html
+ * <ody-inline-list separator="bullet" gap="8">
+ *   <ody-inline-list-item>One</ody-inline-list-item>
+ *   <ody-inline-list-item>Two</ody-inline-list-item>
+ * </ody-inline-list>
+ * ```
+ */
+declare class OdyInlineList extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-inline-list-item>` — a single item inside an `<ody-inline-list>`. Item
+ * content is the element's child content.
+ */
+declare class OdyInlineListItem extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-list-item>` — a clickable list row with content on the left and a
+ * forward chevron on the right. The row content is the element's child content.
+ * Clicking (or pressing Enter/Space) emits a `select` `CustomEvent` whose
+ * `detail` is `{ itemId }`.
+ *
+ * Attributes:
+ * - `item-id` — identifier emitted in the `select` event.
+ * - `active-item-id` — when it equals `item-id`, the row renders active.
+ * - `active` — force the active style regardless of the ids.
+ */
+declare class OdyListItem extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+type OdyProductIndicatorSize = 'base' | 'small';
+/**
+ * `<ody-product-indicator>` — a coloured vertical bar beside a product name and
+ * optional detail line. Extra content (e.g. a tag) is the element's child
+ * content, rendered after the name/detail.
+ *
+ * Attributes:
+ * - `name` — the product name (bold line).
+ * - `detail` — a secondary detail line.
+ * - `bar-color` — CSS colour for the accent bar (default neutral-400).
+ * - `text-color` — CSS colour for the name text.
+ * - `size` — `base` | `small` (default `base`).
+ * - `indicator-id` — when set together with `clickable`, emitted in the `select`
+ *   event `detail` as `{ id }`.
+ * - `clickable` — makes the whole indicator a button that emits `select`.
+ */
+declare class OdyProductIndicator extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+type OdyToggleButtonSize = 'base' | 'small';
+/** A single option in an {@link OdyToggleButton} group. */
+interface OdyToggleOption {
+    /** Value emitted in the `change` event when selected. */
+    value: string;
+    /** Visible label (omit for an icon-only button). */
+    label?: string;
+    /** Optional leading icon name. */
+    leftIcon?: string;
+    /** Optional trailing icon name. */
+    rightIcon?: string;
+    /** Render as an icon-only square button. */
+    iconOnly?: boolean;
+    /** Disable this individual option. */
+    disabled?: boolean;
+}
+/**
+ * `<ody-toggle-button>` — a segmented control of mutually-exclusive buttons.
+ * Selecting an option emits a `change` `CustomEvent` whose `detail` is
+ * `{ value }`; the `selected` attribute reflects the active value.
+ *
+ * Attributes:
+ * - `options` — JSON array of {@link OdyToggleOption} (e.g.
+ *   `options='[{"value":"day","label":"Day"},{"value":"week","label":"Week"}]'`).
+ * - `selected` — the currently-selected option value.
+ * - `size` — `base` | `small` (default `base`).
+ * - `disabled` — disables the whole group.
+ */
+declare class OdyToggleButton extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+/** Gap between section children, in pixels. */
+type OdySectionGap = '8' | '16' | '24' | '32';
+/** Vertical alignment for columns. */
+type OdySectionVerticalAlign = 'center' | 'top' | 'bottom';
+/**
+ * `<ody-section-columns>` — lays out child `<ody-section-column-item>` elements
+ * in a row.
+ *
+ * Attributes:
+ * - `gap-size` — `8` | `16` | `24` | `32` px (default `16`).
+ * - `vertical-align` — `center` | `top` | `bottom` (default `bottom`).
+ */
+declare class OdySectionColumns extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-section-column-item>` — a column inside `<ody-section-columns>`.
+ *
+ * Attributes (boolean flags):
+ * - `no-grow` — size to content instead of filling.
+ * - `individual-scroll` — scroll this column independently.
+ * - `stretch` — stretch to the row's height.
+ * - `with-padding` — add 16px internal padding.
+ */
+declare class OdySectionColumnItem extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-section-rows>` — stacks child `<ody-section-row-item>` elements
+ * vertically.
+ *
+ * Attributes:
+ * - `gap-size` — `8` | `16` | `24` | `32` px (default `16`).
+ */
+declare class OdySectionRows extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-section-row-item>` — a row inside `<ody-section-rows>`, optionally with
+ * a title/description header and a trailing divider.
+ *
+ * Attributes:
+ * - `title` — bold header line.
+ * - `description` — secondary header line.
+ * - `description-icon` — named icon shown before the description.
+ * - `no-divider` — suppress the trailing divider.
+ */
+declare class OdySectionRowItem extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-two-column>` — a master/detail layout: a main content area beside an
+ * optional secondary panel. Compose with `<ody-two-column-main>` and
+ * `<ody-two-column-secondary>` children. The secondary panel is shown only when
+ * the `secondary-open` attribute is present.
+ *
+ * Attributes:
+ * - `secondary-open` — when present, reveals the secondary panel.
+ *
+ * Example:
+ * ```html
+ * <ody-two-column secondary-open>
+ *   <ody-two-column-main>…list…</ody-two-column-main>
+ *   <ody-two-column-secondary>
+ *     <ody-two-column-secondary-header title="Details"></ody-two-column-secondary-header>
+ *     …detail…
+ *   </ody-two-column-secondary>
+ * </ody-two-column>
+ * ```
+ */
+declare class OdyTwoColumn extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-two-column-main>` — the primary content area inside `<ody-two-column>`.
+ */
+declare class OdyTwoColumnMain extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-two-column-secondary>` — the secondary/detail panel inside
+ * `<ody-two-column>`. Hidden unless the parent has `secondary-open`.
+ */
+declare class OdyTwoColumnSecondary extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-two-column-secondary-header>` — a title bar with a close button for the
+ * secondary panel. Clicking the close button emits a `close` `CustomEvent`.
+ *
+ * Attributes:
+ * - `title` — the header title text.
+ */
+declare class OdyTwoColumnSecondaryHeader extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+/**
+ * `<ody-collapsible-section>` — a titled section that expands/collapses on
+ * header click. Place the expandable body in an `<ody-collapsible-content>`
+ * child and the optional always-visible-when-collapsed teaser in an
+ * `<ody-collapsible-collapsed>` child. Toggling emits an `expanded`
+ * `CustomEvent` whose `detail` is `{ expanded }`.
+ *
+ * Attributes:
+ * - `header-text` — the header label.
+ * - `secondary-header-text` — lighter text after the header label.
+ * - `icon` — optional named icon before the header label.
+ * - `expanded` — open initially / reflects the open state.
+ *
+ * Example:
+ * ```html
+ * <ody-collapsible-section header-text="Details" icon="info">
+ *   <ody-collapsible-collapsed>Tap to see more</ody-collapsible-collapsed>
+ *   <ody-collapsible-content>…full content…</ody-collapsible-content>
+ * </ody-collapsible-section>
+ * ```
+ */
+declare class OdyCollapsibleSection extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected render(): void;
+}
+/**
+ * `<ody-collapsible-collapsed>` — teaser content shown only while the parent
+ * `<ody-collapsible-section>` is collapsed.
+ */
+declare class OdyCollapsibleCollapsed extends OdyElement {
+    protected render(): void;
+}
+/**
+ * `<ody-collapsible-content>` — the body shown only while the parent
+ * `<ody-collapsible-section>` is expanded.
+ */
+declare class OdyCollapsibleContent extends OdyElement {
+    protected render(): void;
+}
+type OdyInputSize = 'base' | 'small';
+type OdyInputState = 'warning' | 'info';
+/**
+ * `<ody-input>` — the Odyssey text field. Renders a native `<input>` (or
+ * `<textarea>`) in the light DOM so it stays form-friendly and accessible.
+ *
+ * Attributes:
+ * - `label` — optional caption shown above the field.
+ * - `placeholder` — native placeholder text.
+ * - `value` — current value (also a JS property; see {@link value}).
+ * - `size` — `base` | `small` (default `base`).
+ * - `icon` — optional leading icon name.
+ * - `caption` — neutral helper text in the footer.
+ * - `warning` / `info` — message text; also sets the `warning`/`info` state ring.
+ * - `maxlength` — when set, shows a character counter.
+ * - `textarea` — render a multi-line `<textarea>` instead of an `<input>`.
+ * - `readonly`, `disabled`, `full-width`, `max-content` — boolean flags.
+ * - `no-clear` — suppress the clear button even when there is a value.
+ *
+ * Events: dispatches `input` (on every keystroke) and `change` (on the native
+ * change / clear) as `CustomEvent<{ value: string }>`, bubbling.
+ */
+declare class OdyInput extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Current field value. */
+    get value(): string;
+    set value(next: string);
+    protected render(): void;
+}
+type OdyInlineInputSize = 'base' | 'small';
+/**
+ * `<ody-inline-input>` — the thin "inline" variant of {@link OdyInput}. Same
+ * native-control behaviour, but with the compact `ody-inline-input__group`
+ * chrome (a borderless label/field row used inside tables and forms).
+ *
+ * Attributes mirror `<ody-input>`: `label`, `placeholder`, `value`, `size`,
+ * `icon`, `caption`, `warning`, `info`, `maxlength`, `textarea`, `readonly`,
+ * `disabled`, `full-width`, `max-content`, `no-clear`.
+ *
+ * Events: `input` and `change` as `CustomEvent<{ value: string }>`, bubbling.
+ */
+declare class OdyInlineInput extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Current field value. */
+    get value(): string;
+    set value(next: string);
+    protected render(): void;
+}
+type OdySearchInputSize = 'base' | 'small';
+/**
+ * `<ody-search-input>` — a text field with a leading search icon and a
+ * focus-tracking container. Renders a native `<input>` in the light DOM.
+ *
+ * Attributes:
+ * - `value` — current value (also a JS property; see {@link value}).
+ * - `placeholder` — placeholder text (default `"Search"`).
+ * - `size` — `base` | `small` (default `base`).
+ * - `info-message` — neutral helper caption.
+ * - `warning-message` — warning caption + ring.
+ * - `disabled` — boolean flag.
+ *
+ * Events: dispatches `input` and `change` as `CustomEvent<{ value: string }>`,
+ * bubbling. The container gains `ody-search-input--focused` while focused.
+ */
+declare class OdySearchInput extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Current field value. */
+    get value(): string;
+    set value(next: string);
+    protected render(): void;
+}
+type OdyMoneyInputSize = 'base' | 'small';
+/**
+ * `<ody-money-input>` — a currency amount field. Renders a native `<input>`
+ * with a leading currency symbol; on blur the value is sanitised to digits and
+ * a decimal point, clamped to `max-amount`, and rounded to the currency's
+ * precision (JPY → 0 decimals, everything else → 2).
+ *
+ * Attributes:
+ * - `value` — the amount string (also a JS property; see {@link value}).
+ * - `currency` — ISO code used for the symbol + precision (default `USD`).
+ * - `max-amount` — optional upper clamp applied on blur.
+ * - `label`, `size`, `warning` — passed through to the field chrome.
+ * - `readonly`, `disabled` — boolean flags.
+ *
+ * Events: `input` (per keystroke) and `change` (on blur, after formatting),
+ * each `CustomEvent<{ value: string }>`, bubbling.
+ */
+declare class OdyMoneyInput extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Current amount value. */
+    get value(): string;
+    set value(next: string);
+    /** Decimal precision for the configured currency. */
+    get precision(): number;
+    protected render(): void;
+}
+type OdyPercentageInputSize = 'base' | 'small';
+/**
+ * `<ody-percentage-input>` — a numeric field constrained to 0–100 with a
+ * trailing `%`. Keystrokes that are letters/symbols or would push the value
+ * outside the range are blocked; on blur the value is clamped and normalised.
+ *
+ * Attributes:
+ * - `value` — the percentage string (also a JS property; see {@link value}).
+ * - `label`, `size`, `warning` — passed through to the field chrome.
+ * - `readonly`, `disabled` — boolean flags.
+ *
+ * Events: `input` (per keystroke) and `change` (on blur, after clamping),
+ * each `CustomEvent<{ value: string }>`, bubbling.
+ */
+declare class OdyPercentageInput extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Current percentage value. */
+    get value(): string;
+    set value(next: string);
+    protected render(): void;
+}
+type OdyCheckboxSize = 'base' | 'small';
+/**
+ * `<ody-checkbox>` — a single checkbox with an optional label. Renders a native
+ * `<input type="checkbox">` in the light DOM. The Ember addon paints the
+ * check/indeterminate marks with server-hosted background SVGs; to stay
+ * standalone we overlay the bundled `check` / `minus` icons instead.
+ *
+ * Attributes:
+ * - `label` — text shown beside the box.
+ * - `size` — `base` | `small` (default `small`).
+ * - `checked`, `indeterminate`, `disabled` — boolean flags.
+ *
+ * Reflects: `checked`. Events: dispatches `change` as
+ * `CustomEvent<{ checked: boolean; value: boolean }>`, bubbling.
+ */
+declare class OdyCheckbox extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Whether the box is checked (mirrors the `checked` attribute). */
+    get checked(): boolean;
+    set checked(next: boolean);
+    /** Convenience alias for {@link checked}. */
+    get value(): boolean;
+    set value(next: boolean);
+    protected render(): void;
+}
+type OdyRadioButtonGroupSize = 'base' | 'small';
+/** A single selectable option in a radio-button group. */
+interface OdyRadioOption {
+    label: string;
+    value: string;
+}
+/**
+ * `<ody-radio-button-group>` — a fieldset of native radio inputs. Options are
+ * supplied as a JSON array attribute and the current selection is tracked
+ * internally.
+ *
+ * Attributes:
+ * - `options` — JSON array, e.g. `options='[{"label":"A","value":"a"}]'`.
+ * - `value` — the selected option value (also a JS property; see {@link value}).
+ * - `size` — `base` | `small` (default `base`).
+ * - `disabled` — boolean flag applied to every option.
+ *
+ * Events: dispatches `change` as `CustomEvent<{ value: string }>`, bubbling.
+ */
+declare class OdyRadioButtonGroup extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** The selected option value. */
+    get value(): string;
+    set value(next: string);
+    /** Parsed `options`; malformed JSON yields an empty list. */
+    get options(): OdyRadioOption[];
+    protected render(): void;
+}
+type OdyCheckboxGroupSize = 'base' | 'small';
+/** A single selectable option in a checkbox group. */
+interface OdyCheckboxOption {
+    label: string;
+    value: string;
+}
+/**
+ * `<ody-checkbox-group>` — a list of checkboxes with an optional "select all"
+ * parent. Options are supplied as a JSON array attribute and the set of
+ * selected values is tracked internally.
+ *
+ * The parent checkbox reflects the children: checked when all are selected,
+ * indeterminate when some are, and toggling it selects/clears every child.
+ *
+ * Attributes:
+ * - `options` — JSON array, e.g. `options='[{"label":"A","value":"a"}]'`.
+ * - `value` — comma-separated selected values (also a JS array property,
+ *   {@link value}).
+ * - `select-all-label` — when present, renders the parent select-all row.
+ * - `size` — `base` | `small` (default `small`).
+ * - `disabled` — boolean flag applied to every checkbox.
+ *
+ * Events: dispatches `change` as `CustomEvent<{ value: string[] }>`, bubbling.
+ */
+declare class OdyCheckboxGroup extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** The selected option values. */
+    get value(): string[];
+    set value(next: string[]);
+    /** Parsed `options`; malformed JSON yields an empty list. */
+    get options(): OdyCheckboxOption[];
+    protected render(): void;
+}
+/**
+ * `<ody-accordion>` — an expand/collapse panel with a clickable header.
+ *
+ * The header label is set via the `title` attribute (or a `[data-ody-slot]`
+ * header child is not used here — the body content is the element's child
+ * content). Clicking the header toggles the `open` boolean attribute and
+ * dispatches a `toggle` CustomEvent with `{ open }`.
+ *
+ * Attributes:
+ * - `title` — header label text.
+ * - `open` — boolean; whether the body is expanded (reflected, toggled on click).
+ * - `sticky` — boolean; pins the header to the top while scrolling.
+ */
+declare class OdyAccordion extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-collapsible>` — a lightweight inline collapsible. The header is an
+ * inline label + chevron; clicking it toggles the `open` boolean attribute and
+ * dispatches a `toggle` CustomEvent with `{ open }`. The body content is the
+ * element's child content and is shown only when expanded.
+ *
+ * Attributes:
+ * - `label` — header label text.
+ * - `open` — boolean; whether the content is expanded (reflected, toggled on click).
+ */
+declare class OdyCollapsible extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+interface OdyTabDef {
+    id: string;
+    label: string;
+    disabled?: boolean;
+}
+type OdyTabsSize = 'base' | 'small';
+type OdyTabsPosition = 'top' | 'left';
+/**
+ * `<ody-tabs>` — a horizontal tab list. Tabs are supplied as a JSON array via
+ * the `tabs` attribute, e.g. `tabs='[{"id":"a","label":"A"}]'`. The active tab
+ * is tracked in the `active` attribute; clicking a tab updates it and
+ * dispatches a `change` CustomEvent with `{ id }`.
+ *
+ * Attributes:
+ * - `tabs` — JSON array of `{ id, label, disabled? }`.
+ * - `active` — id of the active tab (reflected, defaults to the first tab).
+ * - `size` — `base` | `small` (default `base`).
+ * - `position` — `top` | `left` (default `top`).
+ */
+declare class OdyTabs extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-copy-button>` — a button that copies its `value` to the clipboard via
+ * `navigator.clipboard.writeText`, showing a transient success (or error) state.
+ * Dispatches a `copy` CustomEvent with `{ value, ok }`.
+ *
+ * Attributes:
+ * - `value` — the text copied to the clipboard.
+ * - `label` — optional button label (icon-only when omitted).
+ * - `success-duration` — ms the success/error state is shown (default 1200).
+ */
+declare class OdyCopyButton extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * Fulfillment / check-in status values (ported from the Ember
+ * `FulfillmentStatus` enum on the check-in-status component).
+ */
+type OdyCheckInStatusValue = 'IN_PROGRESS' | 'NO_SHOW' | 'NONE' | 'OVERDUE' | 'RESERVED' | 'RETURNED';
+/**
+ * `<ody-check-in-status>` — a status dot/icon with a label and optional
+ * secondary text. The `status` attribute selects an icon, colour and default
+ * label; an explicit `label` overrides the mapped label.
+ *
+ * Attributes:
+ * - `status` — one of the `OdyCheckInStatusValue` values (default `RESERVED`).
+ * - `label` — overrides the status's default label.
+ * - `optional-text` — optional secondary line below the label.
+ */
+declare class OdyCheckInStatus extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-option>` — a selectable menu/list option row. The option's label/content
+ * is the element's child content. An optional sub-menu affordance (a trailing
+ * icon button) is shown when `sub-menu` is present; clicking it dispatches a
+ * `submenu` CustomEvent. Clicking the row dispatches a `select` CustomEvent.
+ *
+ * Attributes:
+ * - `selected` — boolean; marks the option as selected.
+ * - `disabled` — boolean; disables interaction.
+ * - `sub-menu` — boolean; shows the trailing sub-menu trigger.
+ * - `trigger-icon` — icon name for the sub-menu trigger (default `chevron-right`).
+ */
+declare class OdyOption extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/**
+ * `<ody-split-button>` — a primary action button joined to a dropdown toggle.
+ * The primary label is the `text` attribute; clicking it dispatches a `primary`
+ * CustomEvent. The toggle reveals a click-toggled panel whose content is the
+ * element's child content; toggling dispatches a `toggle` CustomEvent with
+ * `{ open }` and reflects the `open` boolean attribute.
+ *
+ * Attributes:
+ * - `text` — primary button label.
+ * - `variant` — button variant (default `secondary`).
+ * - `size` — `base` | `small` (default `base`).
+ * - `icon` — toggle icon name (default `chevron-down`).
+ * - `open` — boolean; whether the dropdown panel is shown (reflected).
+ */
+declare class OdySplitButton extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdySortDirection$1 = 'UNSET' | 'ASC' | 'DESC';
+/**
+ * `<ody-table-header>` — a sortable column header. Clicking cycles the sort
+ * direction none → desc → asc → none and dispatches a `sort` CustomEvent with
+ * `{ direction, columnId }`. The icon reflects the current direction.
+ *
+ * Attributes:
+ * - `column-name` — the header text.
+ * - `column-id` — passed through in the `sort` event detail.
+ * - `direction` — current sort `UNSET` | `ASC` | `DESC` (reflected, default `UNSET`).
+ * - `static` — boolean; renders a non-interactive header with no sort affordance.
+ * - `rounded-left` / `rounded-right` — boolean; round the matching corners.
+ */
+declare class OdyTableHeader extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    protected render(): void;
+}
+type OdyModalSize = 'base' | 'small' | 'medium' | 'large' | 'full';
+/**
+ * `<ody-modal>` — an overlay dialog that blocks the rest of the page until
+ * dismissed. The backdrop and dialog are portaled to `document.body` so they
+ * escape any clipping ancestor. Body content is the element's child content.
+ *
+ * Attributes:
+ * - `open` — boolean; when present the modal is shown (mirrors {@link open}/{@link close}).
+ * - `heading` — optional title shown in the header.
+ * - `size` — `base` | `small` | `medium` | `large` | `full` (default `base`).
+ * - `icon` — optional named icon shown before the heading.
+ *
+ * Behaviour: clicking the backdrop or pressing Escape closes the modal and
+ * dispatches a `close` {@link CustomEvent}.
+ */
+declare class OdyModal extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Open the modal (sets the `open` attribute). */
+    open(): void;
+    /** Close the modal, removing the `open` attribute and dispatching `close`. */
+    close(): void;
+    protected render(): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+/**
+ * `<ody-popover>` — a floating panel anchored to a trigger, toggled by clicking
+ * the trigger and dismissed by clicking outside. The panel is portaled to
+ * `document.body` and positioned with {@link position}.
+ *
+ * Light-DOM children:
+ * - the **trigger** is the child marked `[data-ody-popover-trigger]`, else the
+ *   first element child (unless `for` is set);
+ * - the **content** is the child marked `[data-ody-popover-content]`, else the
+ *   remaining children.
+ *
+ * Attributes:
+ * - `for` — id of an external trigger element (overrides a slotted trigger).
+ * - `placement` — `top` | `bottom` | `left` | `right` (default `bottom`).
+ *
+ * Dispatches `open` / `close` {@link CustomEvent}s. Methods: {@link open},
+ * {@link close}, {@link toggle}.
+ */
+declare class OdyPopover extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Whether the popover panel is currently shown. */
+    get isOpen(): boolean;
+    /** Show the popover and position it against its trigger. */
+    open(): void;
+    /** Hide the popover. */
+    close(): void;
+    /** Toggle the popover open/closed. */
+    toggle(): void;
+    protected render(): void;
+    disconnectedCallback(): void;
+}
+/**
+ * `<ody-tooltip>` — a small floating label shown when the trigger is hovered or
+ * focused. The tooltip bubble is portaled to `document.body` (so it escapes any
+ * `overflow: hidden` ancestor) and positioned with {@link position}.
+ *
+ * The **trigger** is an external element referenced by `for`, otherwise the
+ * element's slotted child. Tooltip text comes from the `text` attribute, or from
+ * any extra slotted children when a `for` trigger is used.
+ *
+ * Attributes:
+ * - `text` — the tooltip text (alternative to slotted content).
+ * - `placement` — `top` | `bottom` | `left` | `right` (default `top`).
+ * - `for` — id of an external trigger element.
+ */
+declare class OdyTooltip extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Whether the tooltip is currently shown. */
+    get isVisible(): boolean;
+    /** Show the tooltip and position it against its trigger. */
+    show(): void;
+    /** Hide the tooltip. */
+    hide(): void;
+    protected render(): void;
+    disconnectedCallback(): void;
+}
+/**
+ * `<ody-panel>` — a side panel that slides in from the right when `open` is set
+ * and slides out when it is removed. The panel and its overlay are portaled to
+ * `document.body`. Body content is the element's child content.
+ *
+ * Attributes:
+ * - `open` — boolean; toggles the slide-in (mirrors {@link open}/{@link close}).
+ * - `heading` — optional panel title.
+ * - `full-height` — boolean; spans the full viewport height.
+ *
+ * Clicking the overlay or the close button closes the panel and dispatches a
+ * `close` {@link CustomEvent}.
+ */
+declare class OdyPanel extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Open the panel (sets the `open` attribute). */
+    open(): void;
+    /** Close the panel, removing `open` and dispatching `close`. */
+    close(): void;
+    protected render(): void;
+    disconnectedCallback(): void;
+}
+type OdyToastVariant = 'info' | 'success' | 'warning' | 'danger';
+/** Options for {@link toast}. */
+interface OdyToastOptions {
+    /** Visual intent (default `info`). */
+    variant?: OdyToastVariant;
+    /** Optional bold title shown above the message. */
+    title?: string;
+    /** Auto-dismiss delay in ms; `0` disables auto-dismiss (default `4000`). */
+    timeout?: number;
+}
+/**
+ * `<ody-toast-host>` — the stacking container that holds active toasts. It is
+ * portaled to `document.body`. You normally never write this tag yourself;
+ * {@link toast} lazily creates and portals one for you.
+ */
+declare class OdyToastHost extends OdyElement {
+    protected render(): void;
+    /** Render and stack a toast, returning a handle to dismiss it early. */
+    push(message: string, options?: OdyToastOptions): {
+        dismiss: () => void;
+    };
+}
+/**
+ * Show a toast notification, lazily creating an {@link OdyToastHost} portaled to
+ * `document.body` on first use. Returns a handle whose `dismiss()` removes the
+ * toast early.
+ *
+ * ```ts
+ * import { toast } from '@peektravel/app-utilities/ui';
+ * toast('Saved!', { variant: 'success' });
+ * ```
+ */
+declare function toast(message: string, options?: OdyToastOptions): {
+    dismiss: () => void;
+};
+/** A selectable option for the dropdown components. */
+interface OdySelectOption {
+    /** The value stored/emitted when the option is chosen. */
+    value: string;
+    /** The human-readable label shown in the list (defaults to `value`). */
+    label: string;
+    /** When true, the option is shown but cannot be selected. */
+    disabled?: boolean;
+}
+/**
+ * Shared base for `<ody-dropdown-single>` and `<ody-dropdown-multi>`.
+ *
+ * Self-contains the popup panel (no dependency on `<ody-popover>`) so subclasses
+ * fully control ARIA roles, `aria-activedescendant`, and keyboard handling per
+ * the WAI-ARIA combobox / listbox patterns. Subclasses implement the selection
+ * model (single value vs. value array) and the trigger / option rendering.
+ */
+declare abstract class OdySelectBase extends OdyElement {
+    #private;
+    /** Whether the popup panel is currently open. */
+    protected open: boolean;
+    /** Index of the active (virtually-focused) option, or -1 when none. */
+    protected activeIndex: number;
+    /** Current search/filter query when `searchable`. */
+    protected query: string;
+    /** Stable id suffix used to wire up `aria-controls` / `aria-activedescendant`. */
+    protected readonly uid: string;
+    /** Parsed `options`: the JS property wins, else the JSON attribute fallback. */
+    get options(): OdySelectOption[];
+    set options(next: OdySelectOption[]);
+    /** Whether the dropdown is disabled. */
+    get disabled(): boolean;
+    /** Whether the filter input is shown. */
+    protected get searchable(): boolean;
+    /** True once the first render has happened (so setters can re-render safely). */
+    protected get isRendered(): boolean;
+    /** Options after applying the current search query (case-insensitive). */
+    protected get visibleOptions(): OdySelectOption[];
+    /** Whether the given option value is currently selected. */
+    protected abstract isSelected(value: string): boolean;
+    /** Commit a user selection of `option`; subclass updates value + emits. */
+    protected abstract commit(option: OdySelectOption): void;
+    /** Whether choosing an option should close the panel (single yes, multi no). */
+    protected abstract get closeOnSelect(): boolean;
+    /** Build the trigger's inner content (label/placeholder/chips). */
+    protected abstract triggerContent(): string;
+    /** ARIA `aria-multiselectable` value for the listbox (`'true'`/`'false'`). */
+    protected abstract get multiselectable(): boolean;
+    protected render(): void;
+    /** Open the panel and start listening for outside clicks. */
+    protected openPanel(): void;
+    /** Close the panel; optionally restore focus to the trigger. */
+    protected closePanel(focusTrigger?: boolean): void;
+    disconnectedCallback(): void;
+}
+/** Parse a JSON options string into a typed list, tolerating bad input. */
+declare function parseOptions(raw: string): OdySelectOption[];
+/**
+ * `<ody-dropdown-single>` — a select-only combobox following the WAI-ARIA
+ * combobox pattern. The trigger (`role="combobox"`) shows the selected option's
+ * label or the `placeholder`; clicking it opens a `role="listbox"` panel whose
+ * rows reuse the `.ody-option` look. Selection closes the panel.
+ *
+ * Options are supplied either as the {@link options} JS property or as a JSON
+ * `options` attribute fallback (parsed on connect):
+ * `options='[{"value":"a","label":"A","disabled":false}]'`.
+ *
+ * Attributes:
+ * - `value` — the selected option value (reflected; also a JS property).
+ * - `options` — JSON array fallback for {@link options}.
+ * - `placeholder` — text shown when nothing is selected.
+ * - `label` / `aria-label` — accessible name for the combobox trigger.
+ * - `search-placeholder` — placeholder for the filter input when `searchable`.
+ * - `disabled` — boolean; disables the trigger.
+ * - `searchable` — boolean; renders a filter input atop the list.
+ *
+ * Keyboard: ArrowDown/ArrowUp (or Enter/Space) open and move the active option;
+ * Home/End jump to the first/last; Enter selects and closes; Escape closes and
+ * restores focus to the trigger; Tab closes; printable characters typeahead.
+ *
+ * Events: dispatches `change` as `CustomEvent<{ value: string }>` (bubbling) on
+ * user selection only — not when the value is set programmatically.
+ */
+declare class OdyDropdownSingle extends OdySelectBase {
+    static observedAttributes: string[];
+    /** The selected option value. */
+    get value(): string;
+    set value(next: string);
+    protected get closeOnSelect(): boolean;
+    protected get multiselectable(): boolean;
+    protected isSelected(value: string): boolean;
+    protected triggerContent(): string;
+    protected commit(option: OdySelectOption): void;
+}
+/**
+ * `<ody-dropdown-multi>` — a multi-select listbox combobox following the
+ * WAI-ARIA listbox pattern (`aria-multiselectable="true"`). The trigger shows
+ * the selected options as `.ody-tag` chips (or `placeholder` when empty);
+ * clicking it opens the panel. Each option carries a checkbox-style check mark
+ * and `aria-selected`. Toggling an option keeps the panel open.
+ *
+ * Options are supplied either as the {@link options} JS property or as a JSON
+ * `options` attribute fallback (parsed on connect).
+ *
+ * Attributes:
+ * - `value` — comma-delimited selected values (reflected; the JS {@link value}
+ *   property reads/writes a `string[]`).
+ * - `options` — JSON array fallback for {@link options}.
+ * - `placeholder` — text shown when nothing is selected.
+ * - `label` / `aria-label` — accessible name for the combobox trigger.
+ * - `search-placeholder` — placeholder for the filter input when `searchable`.
+ * - `disabled` — boolean; disables the trigger.
+ * - `searchable` — boolean; renders a filter input atop the list.
+ *
+ * Keyboard: ArrowDown/ArrowUp (or Enter/Space) open and move the active option;
+ * Home/End jump to the first/last; Space or Enter toggles the active option;
+ * Escape closes and restores focus to the trigger; Tab closes.
+ *
+ * Events: dispatches `change` as `CustomEvent<{ value: string[] }>` (bubbling)
+ * on user selection only — not when the value is set programmatically.
+ */
+declare class OdyDropdownMulti extends OdySelectBase {
+    #private;
+    static observedAttributes: string[];
+    /** The selected option values as an array. */
+    get value(): string[];
+    set value(next: string[]);
+    protected get closeOnSelect(): boolean;
+    protected get multiselectable(): boolean;
+    protected isSelected(value: string): boolean;
+    protected triggerContent(): string;
+    protected render(): void;
+    protected commit(option: OdySelectOption): void;
+}
+/** A preset shortcut shown beside the calendar. */
+interface OdyDatePreset {
+    /** Button label. */
+    label: string;
+    /** `yyyy-mm-dd` (single) or `yyyy-mm-dd/yyyy-mm-dd` (range). */
+    value: string;
+}
+/** Predicate disabling arbitrary days; assigned as a JS property. */
+type OdyDateDisallowed = (date: Date) => boolean;
+/** Custom display formatter for the trigger label; assigned as a JS property. */
+type OdyDateFormatter = (date: Date) => string;
+/**
+ * `<ody-datepicker>` — a dependency-free calendar date picker following the
+ * WAI-ARIA date-picker-dialog pattern. A tertiary trigger button toggles a
+ * popover containing a `role="grid"` calendar with roving-tabindex keyboard
+ * navigation. Uses native `Date` only (no date library).
+ *
+ * Attributes:
+ * - `value` — selected date `yyyy-mm-dd`, or `start/end` in range mode.
+ * - `min` / `max` — selectable bounds `yyyy-mm-dd` (inclusive).
+ * - `range` — boolean; enables start/end range selection.
+ * - `first-day-of-week` — `0`–`6` (0 = Sunday, default `0`).
+ * - `placeholder` — trigger text shown when no value is selected.
+ * - `presets` — JSON `[{ "label", "value" }]` shortcut buttons.
+ * - `display-format` — how the selected date is shown to the user:
+ *   `short` | `medium` (default) | `long` | `full`. The displayed text is
+ *   localized via `Intl.DateTimeFormat` for the element's `lang`; the `value`
+ *   attribute and `change` payload always stay machine-readable ISO `yyyy-mm-dd`.
+ *
+ * Properties:
+ * - `isDateDisallowed?: (date: Date) => boolean` — disable arbitrary days.
+ * - `formatDate?: (date: Date) => string` — full control of the trigger label.
+ *
+ * Calendar weekday/month names and day labels are localized via `Intl` for the
+ * resolved `lang`. Dispatches a `change` {@link CustomEvent} on **user**
+ * selection only (`{ value }` single, `{ value, start, end }` range, all ISO);
+ * never on a programmatic `value` set.
+ */
+declare class OdyDatePicker extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Disable arbitrary days; not an attribute (functions can't serialize). */
+    isDateDisallowed?: OdyDateDisallowed;
+    /** Custom trigger-label formatter; wins over `display-format`/`Intl`. */
+    formatDate?: OdyDateFormatter;
+    /** Whether the popover is currently shown. */
+    get isOpen(): boolean;
+    /** Show the popover and focus the roving day. */
+    openPopover(): void;
+    /** Hide the popover. */
+    closePopover(): void;
+    protected render(): void;
+    disconnectedCallback(): void;
+}
+/** Horizontal alignment for a column's header and cells. */
+type OdyTableAlign = 'left' | 'center' | 'right';
+/** Active sort direction; `null` means unsorted. */
+type OdySortDirection = 'ascending' | 'descending' | null;
+/** A single column definition (set as a JS property, never an attribute). */
+interface OdyTableColumn {
+    /** Property key read from each row object. */
+    key: string;
+    /** Header text shown to the user. */
+    label: string;
+    /** Whether this column participates in sorting (requires the global `sortable`). */
+    sortable?: boolean;
+    /** Text alignment for the header and the column's cells (default `left`). */
+    align?: OdyTableAlign;
+    /**
+     * Optional custom cell renderer. Receives a fresh per-cell content element and
+     * the row object; populate the element however you like. When omitted the cell
+     * shows the (HTML-escaped) string value of `row[key]`.
+     */
+    render?: (cellEl: HTMLElement, row: OdyTableRow) => void;
+}
+/** A row is an arbitrary record keyed by column `key`. */
+type OdyTableRow = Record<string, unknown>;
+/** `detail` of the `sort-change` event. */
+interface OdyTableSortChangeDetail {
+    key: string;
+    direction: OdySortDirection;
+}
+/** `detail` of the `selection-change` event. */
+interface OdyTableSelectionChangeDetail {
+    selected: OdyTableRow[];
+}
+/** `detail` of the `row-click` event. */
+interface OdyTableRowClickDetail {
+    row: OdyTableRow;
+    index: number;
+}
+/**
+ * `<ody-table>` — a lightweight, data-driven Odyssey data table that renders a
+ * native `<table>` with sortable headers and an optional checkbox selection
+ * column. Rich data is supplied through **JS properties** (`columns`, `data`),
+ * not attributes; scalar configuration uses reflected attributes.
+ *
+ * Properties:
+ * - `columns: OdyTableColumn[]` — column definitions. If omitted, columns are
+ *   auto-generated from the keys of the first data row.
+ * - `data: OdyTableRow[]` (alias `rows`) — the row objects to display.
+ * - `selected: OdyTableRow[]` — read-only getter of the currently selected rows.
+ *
+ * Attributes:
+ * - `selectable` — boolean; adds a leading checkbox column with a header
+ *   select-all (indeterminate when only some rows are selected).
+ * - `sortable` — boolean; globally enables sorting (per-column opt-in via
+ *   `column.sortable`).
+ * - `sort-key` — the column key currently sorted.
+ * - `sort-direction` — `ascending` | `descending`.
+ * - `sticky-header` — boolean; pins the header row while the body scrolls.
+ *
+ * Events (all `CustomEvent`, bubbling):
+ * - `sort-change` — `{ key, direction }` after a header sort cycle.
+ * - `selection-change` — `{ selected }` after the selection changes.
+ * - `row-click` — `{ row, index }` when a body row is clicked.
+ */
+declare class OdyTable extends OdyElement {
+    #private;
+    static observedAttributes: string[];
+    /** Column definitions; setting re-renders. */
+    get columns(): OdyTableColumn[];
+    set columns(next: OdyTableColumn[]);
+    /** Row data; setting re-renders. */
+    get data(): OdyTableRow[];
+    set data(next: OdyTableRow[]);
+    /** Alias for {@link data}. */
+    get rows(): OdyTableRow[];
+    set rows(next: OdyTableRow[]);
+    /** The currently selected rows (read-only). */
+    get selected(): OdyTableRow[];
+    set selected(next: OdyTableRow[]);
+    protected render(): void;
+}
+/**
+ * Brand / fixed-colour icon library for the Odyssey Web Components.
+ *
+ * Generated from the Odyssey SVGs that bake in their own colours or gradients
+ * (logos, illustrations, status art — see `brand-icons-data.ts` and
+ * `scripts/generate-icons.mjs`). Unlike the themeable {@link iconSvg} set, these
+ * keep their original colours and do NOT follow `currentColor`.
+ *
+ * Render one declaratively with `<ody-brand-icon name="…">`, or get the raw
+ * markup via {@link brandIconSvg}.
+ */
+/** Whether a named brand icon is known. */
+declare function hasBrandIcon(name: string): boolean;
+/** All brand icon names, sorted. */
+declare function brandIconNames(): string[];
+/**
+ * Render a named brand icon as an `<svg>` string (keeping its baked-in colours).
+ * Unknown names yield an empty `<svg>` so layout is preserved without throwing.
+ */
+declare function brandIconSvg(name: string, className?: string): string;
+type OdyBrandIconSize = 'extra-small' | 'mid-small' | 'small' | 'base' | 'medium' | 'large' | 'free';
+/**
+ * `<ody-brand-icon>` — renders a named fixed-colour Odyssey brand icon.
+ *
+ * Attributes:
+ * - `name` — brand icon name (see {@link brandIconNames}); unknown renders nothing.
+ * - `size` — one of {@link OdyBrandIconSize} (default `base`); use `free` to
+ *   size from the surrounding box (handy for larger illustrations).
+ */
+declare class OdyBrandIcon extends OdyElement {
+    static observedAttributes: string[];
+    protected render(): void;
+}
+/** A registered icon: its `viewBox` and inner SVG markup. */
+interface OdyIconData {
+    viewBox: string;
+    body: string;
+}
+/** Register (or override) a named icon with raw inner-SVG markup. */
+declare function registerIcon(name: string, innerSvg: string, viewBox?: string): void;
+/** Whether a named icon is known. */
+declare function hasIcon(name: string): boolean;
+/** All registered themeable icon names, sorted. */
+declare function iconNames(): string[];
+/** Build an `<svg>` string from icon data, using the icon's own viewBox. */
+declare function renderIconSvg(icon: OdyIconData, className?: string): string;
+/**
+ * Render a named themeable icon as an `<svg>` string with the given class.
+ * Unknown names yield an empty `<svg>` so layout is preserved without throwing.
+ */
+declare function iconSvg(name: string, className?: string): string;
+/**
+ * Small, framework-agnostic overlay utilities shared by the floating Odyssey
+ * components (modal, popover, tooltip, panel, toast). The Ember addon relied on
+ * `in-element` / `ember-basic-dropdown`; here we re-implement the two things
+ * those gave us — portaling a node to `document.body` and computing a
+ * placement next to an anchor — with a few lines of vanilla DOM.
+ */
+/** Placement of a floating element relative to its anchor. */
+type OdyPlacement = 'top' | 'bottom' | 'left' | 'right';
+/** A `top`/`left` pair (in `px`, document-relative) plus the resolved placement. */
+interface OdyPosition {
+    top: number;
+    left: number;
+    placement: OdyPlacement;
+}
+/**
+ * Append `node` to `document.body` so it escapes any clipping/stacking ancestor.
+ * No-op (returns the node) if the node is already a direct child of `body`.
+ */
+declare function portal<T extends Node>(node: T): T;
+/** Remove a previously {@link portal}ed node from the DOM if it is still attached. */
+declare function removePortal(node: Node): void;
+/**
+ * Compute the `top`/`left` (page coordinates, including scroll offset) for a
+ * `floating` element placed at `placement` relative to `anchor`. The floating
+ * element is centred along the cross axis. If the requested placement would push
+ * the element off the viewport edge, it flips to the opposite side (a single,
+ * basic flip — `top`↔`bottom`, `left`↔`right`).
+ *
+ * Both elements must already be in the DOM so their rects can be measured;
+ * portal the floating element first, then position it.
+ *
+ * @param gap Pixels between the anchor and the floating element (default `8`).
+ */
+declare function position(anchor: Element, floating: Element, placement?: OdyPlacement, gap?: number): OdyPosition;
+export { OdyAccordion, OdyAlert, type OdyAlertVariant, OdyBrandIcon, type OdyBrandIconSize, OdyBreadcrumb, OdyBreadcrumbItem, OdyButton, type OdyButtonAppearance, type OdyButtonSize, type OdyButtonVariant, OdyCard, OdyCheckInStatus, type OdyCheckInStatusValue, OdyCheckbox, OdyCheckboxGroup, type OdyCheckboxGroupSize, type OdyCheckboxOption, type OdyCheckboxSize, OdyCollapsible, OdyCollapsibleCollapsed, OdyCollapsibleContent, OdyCollapsibleSection, OdyCopyButton, type OdyDateDisallowed, OdyDatePicker, type OdyDatePreset, OdyDivider, OdyDropdownMulti, OdyDropdownSingle, OdyElement, OdyEmptyState, type OdyEmptyStateVariant, OdyIcon, type OdyIconData, type OdyIconSize, OdyInlineInput, type OdyInlineInputSize, OdyInlineList, OdyInlineListItem, type OdyInlineListSeparator, OdyInput, type OdyInputSize, type OdyInputState, OdyListItem, OdyLoadingBar, OdyLoadingSpinner, OdyMessage, OdyModal, type OdyModalSize, OdyMoneyInput, type OdyMoneyInputSize, OdyOption, OdyPanel, OdyPercentageInput, type OdyPercentageInputSize, type OdyPlacement, OdyPopover, type OdyPosition, OdyProductIndicator, type OdyProductIndicatorSize, OdyRadioButtonGroup, type OdyRadioButtonGroupSize, type OdyRadioOption, OdySearchInput, type OdySearchInputSize, OdySectionColumnItem, OdySectionColumns, type OdySectionGap, OdySectionRowItem, OdySectionRows, type OdySectionVerticalAlign, OdySelectBase, type OdySelectOption, type OdySortDirection$1 as OdySortDirection, type OdySpinnerSize, OdySplitButton, OdyStat, OdyStatDetail, OdyStatSummary, OdyStatSummaryDetail, type OdyStatTone, OdyStatusDot, type OdyStatusDotColor, type OdyTabDef, OdyTable, type OdyTableAlign, type OdyTableColumn, OdyTableHeader, type OdyTableRow, type OdyTableRowClickDetail, type OdyTableSelectionChangeDetail, type OdyTableSortChangeDetail, type OdySortDirection as OdyTableSortDirection, OdyTabs, type OdyTabsPosition, type OdyTabsSize, OdyTag, type OdyTagColor, type OdyTagSize, type OdyTagVariant, type OdyTermKey, type OdyTerms, OdyToastHost, type OdyToastOptions, type OdyToastVariant, OdyToggleButton, type OdyToggleButtonSize, type OdyToggleOption, OdyTooltip, OdyTwoColumn, OdyTwoColumnMain, OdyTwoColumnSecondary, OdyTwoColumnSecondaryHeader, brandIconNames, brandIconSvg, classes, define, escapeHtml, hasBrandIcon, hasIcon, iconNames, iconSvg, parseOptions, portal, position, registerIcon, registerTranslation, removePortal, renderIconSvg, toast };