@cdevhub/ngx-tw 0.5.0 → 0.6.0

package/types/cdevhub-ngx-tw-time-picker-testing.d.ts

@@ -0,0 +1,129 @@
+import { ComponentHarness, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
+
+/**
+ * The editable numeric fields, in render order. Mirrored here rather than
+ * imported from `@cdevhub/ngx-tw/time-picker` so a test file does not have to
+ * pull in the component entry point just to name a field.
+ */
+type TimePickerHarnessField = 'hour' | 'minute' | 'second';
+/** The two meridiem options of the 12h format. */
+type TimePickerHarnessMeridiem = 'AM' | 'PM';
+/** Filters accepted by `TimePickerHarness.with`. */
+interface TimePickerHarnessFilters extends BaseHarnessFilters {
+    /** Match by the field group's accessible name. */
+    label?: string | RegExp;
+    /** Match disabled / enabled time pickers. */
+    disabled?: boolean;
+}
+/**
+ * Harness for `tw-time-picker`.
+ *
+ * Unlike every other picker in the library this component has **no CDK
+ * overlay** — it renders three `input[role="spinbutton"]` fields inline inside
+ * a `role="group"`, plus an optional stepper pair, an optional AM/PM
+ * radiogroup, and an optional clear button. Nothing here reaches outside the
+ * host, so no `documentRootLocatorFactory()` is involved.
+ *
+ * Fields are addressed by position, not by `aria-label`: every visible string
+ * on this component comes from the injectable `TimePickerIntl` and a localized
+ * app would break a label-based selector.
+ */
+declare class TimePickerHarness extends ComponentHarness {
+    static hostSelector: string;
+    private readonly group;
+    private readonly fields;
+    /**
+     * The two stepper buttons, up then down. They are the only buttons inside a
+     * plain (role-less) wrapper div — the meridiem buttons live in a
+     * `role="radiogroup"` and the clear button is a direct child of the host.
+     */
+    private readonly steppers;
+    /** The AM then PM radio, present only while `format` is `'12h'`. */
+    private readonly meridiemButtons;
+    /** Predicate for `locatorFor` / `locatorForAll`. */
+    static with(options?: TimePickerHarnessFilters): HarnessPredicate<TimePickerHarness>;
+    /**
+     * The field group's accessible name, from `aria-label` on the
+     * `role="group"` wrapper. `null` when the group is named by reference
+     * (`aria-labelledby`) instead — a `<tw-form-field>` label does exactly that.
+     */
+    getLabel(): Promise<string | null>;
+    /** Whether the seconds field is rendered (`showSeconds`). */
+    hasSeconds(): Promise<boolean>;
+    /** Whether the stepper buttons are rendered (`showSteppers`, suppressed at `xs` density). */
+    hasSteppers(): Promise<boolean>;
+    /**
+     * The numeric value of one field, read from its `aria-valuenow`. `null` when
+     * the field is blank. In `12h` format the hour is 1–12 and the meridiem is
+     * read separately via {@link getMeridiem}.
+     */
+    getValue(field: TimePickerHarnessField): Promise<number | null>;
+    /**
+     * The spoken text of one field, from `aria-valuetext` — `'Empty'` for a blank
+     * field, and the hour additionally carries the meridiem in `12h` format.
+     * Exposed because it is what a screen reader announces, which no other read
+     * on this harness reproduces.
+     */
+    getValueText(field: TimePickerHarnessField): Promise<string | null>;
+    /**
+     * Types `value` into one field as two digits, exactly as a user would.
+     *
+     * The component drives entry from `beforeinput`, buffering one digit at a
+     * time, so the first digit lands on its own before the second replaces the
+     * buffer. That means a *partial* time may be committed in between — the same
+     * intermediate emission a real keystroke pair produces. Pass values inside
+     * the field's range (hour 0–23, or 1–12 in `12h` format; minute/second 0–59)
+     * or the component will reject the digit that overflows.
+     */
+    setValue(field: TimePickerHarnessField, value: number): Promise<void>;
+    /** Clears one field's text, leaving the time incomplete. */
+    clearValue(field: TimePickerHarnessField): Promise<void>;
+    /**
+     * The current meridiem, or `null` in `24h` format where no radiogroup is
+     * rendered.
+     */
+    getMeridiem(): Promise<TimePickerHarnessMeridiem | null>;
+    /**
+     * Clicks the AM or PM radio. Throws in `24h` format, where the control does
+     * not exist. Selecting the already-selected meridiem is a no-op, as it is for
+     * a user.
+     */
+    setMeridiem(meridiem: TimePickerHarnessMeridiem): Promise<void>;
+    /**
+     * Focuses `field` and clicks the up stepper, which steps whichever field
+     * holds focus by that field's configured step, wrapping at its bounds.
+     * Throws when the steppers are not rendered.
+     */
+    stepUp(field?: TimePickerHarnessField): Promise<void>;
+    /** Focuses `field` and clicks the down stepper. Throws when the steppers are not rendered. */
+    stepDown(field?: TimePickerHarnessField): Promise<void>;
+    /** Whether every field reports `aria-disabled="true"`. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the fields report `aria-invalid="true"`. */
+    isInvalid(): Promise<boolean>;
+    /**
+     * Whether the fields report `aria-required="true"`. Reflects the `required`
+     * input *and* a `Validators.required` on a bound control.
+     */
+    isRequired(): Promise<boolean>;
+    /**
+     * Whether the clear control is rendered. It appears only while `showClear` is
+     * on, the picker is enabled and not readonly, and a value is set.
+     */
+    hasClearButton(): Promise<boolean>;
+    /** Clicks the clear control. Throws when none is rendered. */
+    clear(): Promise<void>;
+    /** @internal Resolves one field by its position in the spinbutton sequence. */
+    private field;
+    /**
+     * @internal The clear button — the only `<button>` that is a direct child of
+     * the host, the steppers and meridiem radios both sitting inside wrapper
+     * divs.
+     */
+    private clearButton;
+    /** @internal Focuses a field, then clicks the stepper at `index` (0 = up, 1 = down). */
+    private clickStepper;
+}
+
+export { TimePickerHarness };
+export type { TimePickerHarnessField, TimePickerHarnessFilters, TimePickerHarnessMeridiem };

package/types/cdevhub-ngx-tw-time-picker.d.ts

@@ -59,6 +59,16 @@ declare class TimePickerIntl {
  *   }),
  * ]
  * ```
+ *
+ * Keys explicitly set to `undefined` are dropped before merging. Root
+ * `tsconfig.json` does not set `exactOptionalPropertyTypes`, so
+ * `provideTimePickerIntl({ hoursLabel: bundle['time.hours'] })` type-checks
+ * even when the lookup misses — and a plain `Object.assign` would then copy
+ * that `undefined` over a field `TimePickerIntl` types as `string`. Because
+ * this is a bootstrap-level provider, one missing key broke *every*
+ * time-picker in the app: `focusedFieldLabel()` calls `.toLowerCase()` on the
+ * field labels to build the stepper aria-labels, so the picker threw on first
+ * render. Filtering here makes a missing key fall back to the English default.
  */
 declare function provideTimePickerIntl(custom: Partial<TimePickerIntl>): Provider;
 
@@ -115,13 +125,13 @@ type TimePickerValidationErrors = Partial<{
     };
 }>;
 declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implements ControlValueAccessor, Validator, OnInit {
-    /** Id on the time-picker's host element. Auto-generated when not provided. Used by the form-field's `<label for>` attribute. */
+    /** Id on the time-picker's host element. Auto-generated when not provided. The accessible name inside a `<tw-form-field>` comes from `aria-labelledby` on the inner `role="group"` wrapper, not from the field's `<label for>` — the host is a custom element, which `for` cannot target. */
     readonly idInput: _angular_core.InputSignal<string | undefined>;
     /** When true, the whole component is disabled and every field sets `aria-disabled="true"`. Defaults to `false`. */
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** When true, exposes `aria-required="true"`. Validators.required on a bound NgControl is also honoured. Defaults to `false`. */
     readonly requiredInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** When true, blocks typing, stepping, and the AM/PM toggle — the value is still read-only visible. Defaults to `false`. */
+    /** When true, blocks typing, stepping, and the AM/PM toggle — the value is still read-only visible. Defaults to `false`. Alias: `readonly`. */
     readonly readonlyInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Controls field height, font size, and stepper density. Defaults to `'md'`. */
     readonly size: _angular_core.InputSignal<TwSize>;
@@ -129,7 +139,7 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly color: _angular_core.InputSignal<TwColor>;
     /** Visual style of the chrome. `'default'` draws its own border; `'naked'` strips chrome. Auto-resolves to `'naked'` inside `<tw-form-field>`. */
     readonly variant: _angular_core.InputSignal<TimePickerVariant | undefined>;
-    /** `'12h'` renders 1–12 hours with an AM/PM toggle; `'24h'` renders 00–23. Defaults to `'24h'`. */
+    /** `'12h'` renders 1–12 hours with an AM/PM toggle; `'24h'` renders 00–23. The same axis is spelled `timeFormat` on `tw-date-range-picker` and lives under `timeConfig.format` on `tw-date-picker`, where `format` instead means the display-format descriptor. Defaults to `'24h'`. */
     readonly format: _angular_core.InputSignal<TimePickerFormat>;
     /** When true, renders a seconds field after minutes. Defaults to `false`. */
     readonly showSeconds: _angular_core.InputSignal<boolean>;
@@ -147,21 +157,21 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly referenceDate: _angular_core.InputSignal<D | null>;
     /** Placeholder shown in each field when empty. Defaults to `'--'`. */
     readonly placeholder: _angular_core.InputSignal<string | undefined>;
-    /** Whether to render the up/down stepper column. Defaults to `true`. */
+    /** Whether to render the up/down stepper column. Defaults to `true`. Pointer users expect inline up/down chevrons next to a numeric editor; without them the picker reads as a static display and consumers must rebuild stepping for every instance. Ignored at `size="xs"` on the bordered `default` variant, where the 24px control leaves no room for a stacked pair — use ↑/↓ on a field instead. */
     readonly showSteppers: _angular_core.InputSignal<boolean>;
-    /** Whether to render the clear affordance when a value is set. Defaults to `true`. */
+    /** Whether to render the clear affordance when a value is set. Defaults to `true` — it matches `<tw-date-picker>` and `<tw-input>` clear behaviour; without the inline clear every form has to wire its own reset surface for an obvious affordance. */
     readonly showClear: _angular_core.InputSignal<boolean>;
-    /** Accessible label for the clear button. Defaults to `'Clear time'`. */
+    /** Accessible label for the clear button. Note the name differs in meaning from the date pickers, which spell this `clearAriaLabel` and reserve `clearLabel` for the overlay action bar's visible button text. Defaults to `'Clear time'`. */
     readonly clearLabel: _angular_core.InputSignal<string>;
-    /** Per-instance override of the `ErrorStateMatcher`. */
+    /** Per-instance override of the `ErrorStateMatcher`. Defaults to `undefined`. */
     readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
-    /** Accessible name for the fields group. Required when no visible label is supplied. Alias: `aria-label`. */
+    /** Accessible name for the fields group. Required when no visible label is supplied. Alias: `aria-label`. Defaults to `undefined`. */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
-    /** ID of an external element that labels the group. Alias: `aria-labelledby`. */
+    /** ID of an external element that labels the group. Alias: `aria-labelledby`. Defaults to `undefined`. */
     readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
-    /** Consumer-supplied `aria-describedby` ids. The form-field preserves these when merging hint/error ids. Alias: `aria-describedby`. */
+    /** Consumer-supplied `aria-describedby` ids. The form-field preserves these when merging hint/error ids. Alias: `aria-describedby`. Defaults to `undefined`. */
     readonly userAriaDescribedByInput: _angular_core.InputSignal<string | undefined>;
-    /** Two-way bound current time. `null` when empty. Setting programmatically updates the fields without firing `onChange`. */
+    /** Two-way bound current time. `null` when empty. Setting programmatically updates the fields without firing `onChange`. Defaults to `null`. */
     readonly value: _angular_core.ModelSignal<D | null>;
     /** Fires on every keystroke, stepper press, or AM/PM toggle — before the new value is committed. */
     readonly timeInput: _angular_core.OutputEmitterRef<TimePickerInputEvent<D>>;
@@ -175,9 +185,6 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     private readonly injector;
     private readonly formField;
     private ngControl;
-    private readonly parentForm;
-    private readonly parentFormGroup;
-    private readonly defaultMatcher;
     /** @internal — exposed for the template; consumers configure via `provideTimePickerIntl()`. */
     protected readonly intl: TimePickerIntl;
     private readonly hourInputRef;
@@ -200,9 +207,10 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly internalValue: _angular_core.WritableSignal<D | null>;
     private readonly cvaDisabled;
     private readonly describedByIdsSignal;
+    private readonly labelledByIdsSignal;
     private readonly focusedSignal;
-    private readonly _ngControlRev;
-    private readonly _formSubmitRev;
+    /** @internal Shared `errorState` / `required` / `errors` derivation — see `wireErrorState`. */
+    private readonly errorWiring;
     /** When true, an effect should not rewrite field text from the external value. */
     private editing;
     private onChange;
@@ -213,6 +221,23 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly isEmpty: Signal<boolean>;
     /** @internal Effective variant — auto-naked when wrapped in tw-form-field. */
     readonly resolvedVariant: Signal<TimePickerVariant>;
+    /**
+     * @internal Whether the stepper column actually renders.
+     *
+     * `showSteppers` stays the consumer's switch, but the column is geometrically
+     * impossible at `size="xs"` on the bordered `default` variant: the pinned h-6
+     * root is 24px border-box, leaving a 22px content box, while a stacked pair of
+     * chevron buttons has a 24px min-content height (2 × size-3). Rendering it
+     * anyway would either overflow the shell or squeeze each button to 11px — far
+     * under any usable pointer target. The `naked` variant keeps its steppers: it
+     * draws no border, so in the date-picker / date-range-picker overlay footers a
+     * 24px row leaves a full 24px content box and the pair fits exactly. (Inside
+     * `<tw-form-field>` the row is governed by the field's own padding and its
+     * `min-h-*` floor, which is a minimum — the row grows rather than clipping.)
+     * Stepping stays available everywhere via ↑/↓ on a focused field, so nothing
+     * becomes unreachable.
+     */
+    readonly steppersVisible: Signal<boolean>;
     /** @internal */
     readonly hourMin: Signal<number>;
     /** @internal */
@@ -231,8 +256,23 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     readonly secondValueNow: Signal<number | null>;
     /** @internal */
     readonly secondValueText: Signal<string>;
-    /** @internal */
-    readonly groupAriaLabel: Signal<string>;
+    /**
+     * @internal Merged `aria-labelledby` for the `role="group"` wrapper: the ids a
+     * wrapping `<tw-form-field>` pushes down (its projected `<label twLabel>` plus
+     * anything the consumer supplied) or, standalone, the consumer's own
+     * `aria-labelledby`. The host is `<tw-time-picker>`, a custom element the
+     * field's `<label for>` cannot target, so this attribute is the only route
+     * from the visible label to the composite. Returns `null` when nothing labels
+     * the group by reference.
+     */
+    readonly groupLabelledBy: Signal<string | null>;
+    /**
+     * @internal `aria-label` for the group. An explicit `aria-label` always wins;
+     * otherwise the generic intl fallback is suppressed whenever `groupLabelledBy`
+     * already names the group, so a real label is not shadowed by "Time" in the
+     * accessibility tree inspector.
+     */
+    readonly groupAriaLabel: Signal<string | null>;
     /** @internal Label of the currently focused field, used by stepper aria-labels. */
     readonly focusedFieldLabel: Signal<string>;
     /** @internal */
@@ -254,12 +294,27 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     /** @internal */ readonly focused: Signal<boolean>;
     /** @internal */ readonly empty: Signal<boolean>;
     /** @internal */ readonly disabled: Signal<boolean>;
-    /** @internal */ readonly required: Signal<boolean>;
+    /**
+     * Whether the control is required — the `required` input OR `Validators.required`
+     * on a bound `NgControl`. Bound to `aria-required` on each spinbutton field, not on
+     * the `role="group"` wrapper, which does not permit the attribute.
+     */
+    readonly required: Signal<boolean>;
     /** @internal */
     readonly errorState: Signal<boolean>;
+    /**
+     * @internal Active validation errors map from the bound `NgControl` (or `null` when the
+     * control reports none / is unbound). This is what `[twError match="…"]` filters on inside a
+     * `<tw-form-field>`; without it every `match`-targeted message — including the
+     * `timePickerMin` / `timePickerMax` codes this component's `NG_VALIDATORS` apparatus exists
+     * to produce — stays permanently hidden.
+     */
+    readonly errors: Signal<Record<string, unknown> | null>;
     /** @internal */ readonly controlType = "time-picker";
     /** @internal */
     readonly userAriaDescribedBy: Signal<string | undefined>;
+    /** @internal Consumer-supplied `aria-labelledby`, surfaced so the wrapping form-field merges it into the ids it pushes back rather than replacing it. */
+    readonly userAriaLabelledby: Signal<string | undefined>;
     constructor();
     ngOnInit(): void;
     /** Moves focus to the hours field. */
@@ -318,6 +373,8 @@ declare class TimePickerComponent<D = Date> extends FormFieldControl<D> implemen
     setDisabledState(isDisabled: boolean): void;
     /** @internal */
     setDescribedByIds(ids: string[]): void;
+    /** @internal Receives the merged `aria-labelledby` ids from the wrapping form-field and applies them to the `role="group"` wrapper. Required because the host is a custom element rather than a labelable control, so the field's `<label for>` never reaches it. */
+    setLabelledByIds(ids: string[]): void;
     /** @internal */
     onContainerClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent<any>, never>;

package/types/cdevhub-ngx-tw-timeline.d.ts

@@ -12,19 +12,38 @@ type TimelineAlign = 'left' | 'right' | 'alternate' | 'split';
 type TimelineLineStyle = 'solid' | 'dashed';
 /** Visibility policy for the horizontal-overflow chevron buttons. */
 type TimelineScrollControls = 'auto' | 'always' | 'never';
-/** Localisable labels for the horizontal-overflow chevron buttons on `tw-timeline`. */
+/**
+ * Localisable labels for the horizontal-overflow chevron buttons on
+ * `tw-timeline`.
+ *
+ * Every member is optional. This interface only ever reaches consumers through
+ * `provideTwTimelineScrollLabels(labels: Partial<TwTimelineScrollLabels>)`, and
+ * unset keys fall back to {@link DEFAULT_TW_TIMELINE_SCROLL_LABELS} — so a
+ * consumer who annotates a complete literal must not be forced to restate keys
+ * they do not override, and adding a label in a future minor must not break
+ * them on a non-major release. `scrollRegion` was already optional for exactly
+ * this reason when it was added after the interface shipped; making the other
+ * two optional is the structural version of the same fix, so the next added
+ * label does not reproduce the break.
+ */
 interface TwTimelineScrollLabels {
     /** Accessible label for the previous-scroll chevron. Used as `aria-label`. Defaults to `'Scroll to previous events'`. */
-    scrollPrevious: string;
+    scrollPrevious?: string;
     /** Accessible label for the next-scroll chevron. Used as `aria-label`. Defaults to `'Scroll to next events'`. */
-    scrollNext: string;
+    scrollNext?: string;
+    /** Accessible label for the horizontal scroll viewport, which is a keyboard-focusable scrollable region. Defaults to `'Timeline events'`. */
+    scrollRegion?: string;
 }
-/** Default English labels used when `TW_TIMELINE_SCROLL_LABELS` is not provided. */
-declare const DEFAULT_TW_TIMELINE_SCROLL_LABELS: TwTimelineScrollLabels;
+/**
+ * Default English labels used when `TW_TIMELINE_SCROLL_LABELS` is not provided.
+ * Typed `Required<TwTimelineScrollLabels>` so readers keep a non-optional
+ * `string` for every key even though the interface itself is all-optional.
+ */
+declare const DEFAULT_TW_TIMELINE_SCROLL_LABELS: Required<TwTimelineScrollLabels>;
 /**
  * Injection token carrying localisable `aria-label` strings for the timeline's
- * horizontal-overflow chevron buttons. The container uses these labels exclusively
- * on the prev/next buttons; they do not affect any other rendered text.
+ * horizontal-overflow affordances — the prev/next chevron buttons and the
+ * scrollable viewport between them. They do not affect any other rendered text.
  *
  * Provide via `provideTwTimelineScrollLabels({ ... })` at the root or feature level.
  * If both keys are present they override the English defaults; if only one is present
@@ -129,19 +148,24 @@ declare class TimelineComponent {
     private readonly _directionality;
     private readonly _viewportRef;
     private readonly _scrollLabelsOverride;
-    /** @internal Live `dir` from CDK `Directionality`. */
+    /**
+     * @internal Live `dir` from CDK `Directionality`. Read straight from
+     * `valueSignal` (CDK 22+) so `_isRtl` re-evaluates on a runtime `dir` flip
+     * with no manual subscription mirror.
+     */
     private readonly _cdkDir;
     /** @internal True when the host renders inside a `dir="rtl"` ancestor. */
     readonly _isRtl: _angular_core.Signal<boolean>;
     /**
-     * @internal Defaults to `false` until the first measurement runs in
-     * `afterNextRender`. This avoids a one-frame "enabled-then-disabled" flash
-     * where the buttons appear live before the scroll state has been read.
+     * @internal Defaults to `false` until the first measurement runs in the
+     * `afterRenderEffect` in the constructor. This avoids a one-frame
+     * "enabled-then-disabled" flash where the buttons appear live before the
+     * scroll state has been read.
      */
     readonly _canScrollPrev: _angular_core.WritableSignal<boolean>;
     readonly _canScrollNext: _angular_core.WritableSignal<boolean>;
     /** @internal Resolved label record. Falls back to English defaults for any missing key. */
-    readonly scrollLabels: _angular_core.Signal<TwTimelineScrollLabels>;
+    readonly scrollLabels: _angular_core.Signal<Required<TwTimelineScrollLabels>>;
     /** @internal True when the prev button should be aria-hidden + visually suppressed. */
     readonly _prevButtonHidden: _angular_core.Signal<boolean>;
     /** @internal True when the next button should be aria-hidden + visually suppressed. */

package/types/cdevhub-ngx-tw-toast.d.ts

@@ -176,7 +176,16 @@ declare class ToastConfig<D = unknown, _R = unknown> {
     severity?: ToastSeverity;
     /** Screen position of the toast stack. Defaults to `'bottom-right'`. */
     position?: ToastPosition;
-    /** Auto-dismiss duration in ms. `0` disables auto-dismiss. Defaults to `5000`. */
+    /**
+     * Auto-dismiss duration in ms. `0` disables auto-dismiss. Defaults to `5000`.
+     *
+     * The duration alone would fail SC 2.2.1 (Timing Adjustable) — a time limit the
+     * user cannot influence. What makes 5s conformant is `pauseOnInteraction`
+     * (default `true`): the clock stops while the pointer is over the toast or
+     * focus is anywhere inside it, and resumes on leave / blur. Setting
+     * `pauseOnInteraction: false` alongside a non-zero duration re-introduces the
+     * failure, so pair it with `duration: 0`.
+     */
     duration?: number;
     /** When true, renders a close (×) button. Defaults to `true`. */
     dismissible?: boolean;
@@ -201,7 +210,7 @@ declare class ToastConfig<D = unknown, _R = unknown> {
      * primitives for the string-content path.
      */
     icon?: string | false;
-    /** When true, pause the auto-dismiss timer while the toast is hovered or holds focus. Defaults to `true`. */
+    /** When true, pause the auto-dismiss timer while the toast is hovered or holds focus anywhere inside it, resuming on leave / blur. Defaults to `true`. */
     pauseOnInteraction?: boolean;
     /** Enable horizontal swipe-to-dismiss via pointer gestures. Defaults to `true`. */
     swipeToDismiss?: boolean;
@@ -226,6 +235,11 @@ declare const TW_TOAST_DEFAULT_OPTIONS: InjectionToken<Partial<ToastConfig<unkno
 /** Accepted content forms for `ToastService.show()`. */
 type ToastContent = string | TemplateRef<ToastTemplateContext> | Type<unknown>;
 
+/**
+ * The three messages {@link ToastService.promise} shows as a promise settles.
+ * `success` and `error` may be functions, receiving the resolved value or the
+ * rejection reason so the message can quote it.
+ */
 interface PromiseMessages<T> {
     loading: string;
     success: string | ((value: T) => string);
@@ -376,7 +390,7 @@ declare class ToastActionDirective {
 declare class ToastComponent {
     /** Severity variant. Drives color palette, default icon, and ARIA role / live politeness. Defaults to `'info'`. */
     readonly severity: _angular_core.InputSignal<ToastSeverity>;
-    /** Whether to render the close button. Defaults to `true`. */
+    /** Whether to render the close button. Defaults to `true` — mirroring `ToastConfig.dismissible`, toasts must offer an escape hatch; the special case is an ephemeral progress marker paired with `duration`. */
     readonly dismissible: _angular_core.InputSignal<boolean>;
     /**
      * Icon override. Pass a string to render as text inside the icon slot, or
@@ -386,7 +400,7 @@ declare class ToastComponent {
      * For arbitrary icon markup, project a `[twToastIcon]` child instead.
      */
     readonly icon: _angular_core.InputSignal<string | false | undefined>;
-    /** Explicit aria-label for the toast wrapper. When omitted, text content is used by assistive tech. */
+    /** Explicit aria-label for the toast wrapper. Mirrored to `aria-label`. When omitted, text content is used by assistive tech. Defaults to `undefined`. */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     /** Fires when the close button is clicked. */
     readonly dismissed: _angular_core.OutputEmitterRef<void>;
@@ -416,8 +430,8 @@ declare class ToastComponent {
     /** @internal */
     protected readonly ariaLiveAttr: _angular_core.Signal<"polite" | "assertive">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "tw-toast", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; "actionClicked": "actionClicked"; }, ["projectedIcon"], ["[twToastIcon]", "[twToastTitle]", "[twToastDescription]", "*", "[twToastAction]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "tw-toast", never, { "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; "actionClicked": "actionClicked"; }, ["projectedIcon"], ["[twToastIcon]", "[twToastTitle]", "[twToastDescription]", "*", "[twToastAction]"], true, never>;
 }
 
 export { TW_TOAST_DATA, TW_TOAST_DEFAULT_OPTIONS, TW_TOAST_REF, ToastActionDirective, ToastComponent, ToastConfig, ToastDescriptionDirective, ToastIconDirective, ToastRef, ToastService, ToastTitleDirective, provideToast };
-export type { ToastAction, ToastContent, ToastDismissReason, ToastDismissal, ToastPosition, ToastSeverity, ToastState, ToastTemplateContext, ToastUpdatePatch };
+export type { PromiseMessages, ToastAction, ToastContent, ToastDismissReason, ToastDismissal, ToastPosition, ToastSeverity, ToastState, ToastTemplateContext, ToastUpdatePatch };

package/types/cdevhub-ngx-tw-tooltip.d.ts

@@ -20,17 +20,19 @@ declare class TooltipDirective {
      */
     readonly twTooltipShowDelay: _angular_core.InputSignal<number>;
     /**
-     * Milliseconds to wait before hiding after trigger ends. Defaults to `0`
-     * (immediate dismiss). The asymmetry with `twTooltipShowDelay` is
-     * intentional — show is gated to filter noise, hide is instant so the
-     * tooltip never lingers over content the user has moved on from.
+     * Milliseconds to wait before hiding after the trigger is left. Defaults to
+     * `150` — a grace period, not a lingering delay: WCAG 2.1 SC 1.4.13 requires
+     * the tooltip to be hoverable, and the panel sits 8px clear of its trigger,
+     * so the pointer needs a window in which to cross that gap. Hovering the
+     * panel itself cancels the pending hide entirely. Set `0` to opt out (the
+     * tooltip is then dismissible by Escape but not reachable by pointer).
      */
     readonly twTooltipHideDelay: _angular_core.InputSignal<number>;
     /** When true, tooltip never shows. Defaults to `false`. */
     readonly twTooltipDisabled: _angular_core.InputSignal<boolean>;
-    /** When true, renders an arrow pointing to the trigger. Defaults to `true`. */
+    /** When true, renders an arrow pointing to the trigger. Defaults to `true` — arrows reinforce the visual association between the floating panel and its trigger and match every other ngx-tw overlay (popover, menu); the special case is a compact iconic context. */
     readonly twTooltipArrow: _angular_core.InputSignal<boolean>;
-    /** Optional class string (space-separated) merged into the panel slot for consumer customization. */
+    /** Optional class string (space-separated) merged into the panel slot for consumer customization. Defaults to an empty string. */
     readonly twTooltipPanelClass: _angular_core.InputSignal<string>;
     /** Fires when the tooltip becomes visible. */
     readonly twTooltipShown: _angular_core.OutputEmitterRef<void>;
@@ -41,9 +43,18 @@ declare class TooltipDirective {
     private readonly destroyRef;
     private readonly ariaDescriber;
     private overlayRef;
+    /**
+     * The live position strategy. Held as a field so every show can re-apply
+     * `twTooltipPosition` onto it — see `applyPositions`.
+     */
+    private positionStrategy;
+    /** The `twTooltipPosition` value currently baked into `positionStrategy`. */
+    private appliedPosition;
     private tooltipInstance;
     private showTimer;
     private hideTimer;
+    /** Removes the panel's hover listeners. Set in `createOverlay`, invoked from `disposeOverlay`. */
+    private overlayHoverCleanup;
     /** Last description string handed to `AriaDescriber.describe` — required so the symmetrical `removeDescription` call passes the same key. */
     private _describedBy;
     /** True when the trigger's `aria-describedby` was set directly to the overlay id (TemplateRef fallback path); used by `removeAriaDescription` to choose the symmetrical teardown. */
@@ -64,6 +75,17 @@ declare class TooltipDirective {
     protected onTouchEnd(): void;
     private createAndShow;
     private createOverlay;
+    /**
+     * Pushes the current `twTooltipPosition` onto the live position strategy.
+     *
+     * Updating the strategy in place rather than disposing the `OverlayRef` on
+     * hide is not just the cheaper option — it is the correct one. `createOverlay`
+     * subscribes to `positionStrategy.positionChanges` exactly once, and that feed
+     * is what drives the arrow direction; `FlexibleConnectedPositionStrategy`
+     * completes that subject in `dispose()`, so a dispose-on-hide would silently
+     * kill arrow placement from the second show onward.
+     */
+    private applyPositions;
     private updateTooltip;
     private detach;
     /**