@vadem/ui 0.0.0-stage → 0.0.1

package/types/vadem-ui-rating.d.ts

@@ -0,0 +1,95 @@
+import * as i0 from "@angular/core";
+import { OnInit, Signal } from "@angular/core";
+import { FormValueControl } from "@angular/forms/signals";
+type VdRatingSize = 'sm' | 'md' | 'lg';
+/** Whole-star rating. The legend names the group; Field supplies hints/errors. */
+export declare class VdRating implements FormValueControl<number>, OnInit {
+  readonly value: import("@angular/core").ModelSignal<number>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly starLabel: import("@angular/core").InputSignal<((value: number) => string) | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: Signal<Pick<{
+    starLabel: (value: number) => string;
+  }, "starLabel">>;
+  readonly size: import("@angular/core").InputSignal<VdRatingSize>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly readonly: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly invalid: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly touched: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly required: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly touch: import("@angular/core").OutputEmitterRef<void>;
+  readonly controlId: string;
+  protected readonly labelId: string;
+  protected readonly stars: number[];
+  protected readonly preview: import("@angular/core").WritableSignal<number>;
+  protected readonly selected: Signal<number>;
+  protected readonly filled: Signal<number>;
+  protected readonly field: import("@vadem/ui/field").VdFieldContext | null;
+  private readonly host;
+  private readonly injector;
+  private readonly destroyRef;
+  private readonly formBound;
+  private readonly ngSource;
+  private readonly ngState;
+  protected readonly isDisabled: Signal<boolean>;
+  protected readonly locked: Signal<boolean>;
+  protected readonly isRequired: Signal<boolean>;
+  protected readonly showInvalid: Signal<boolean>;
+  constructor();
+  ngOnInit(): void;
+  protected choose(value: number): void;
+  protected onKeydown(event: KeyboardEvent, star: number): void;
+  protected onFocusOut(event: FocusEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdRating, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdRating, "vd-rating", never, {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "starLabel": {
+      "alias": "starLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "readonly": {
+      "alias": "readonly";
+      "required": false;
+      "isSignal": true;
+    };
+    "invalid": {
+      "alias": "invalid";
+      "required": false;
+      "isSignal": true;
+    };
+    "touched": {
+      "alias": "touched";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "value": "valueChange";
+    "touch": "touch";
+  }, never, never, true, never>;
+}
+export type { VdRatingSize };

package/types/vadem-ui-relative-time.d.ts

@@ -0,0 +1,58 @@
+import * as i0 from "@angular/core";
+import { PipeTransform } from "@angular/core";
+export declare class VdRelativeTimePipe implements PipeTransform {
+  private readonly texts;
+  transform(value: number | null | undefined, now: number | null | undefined, locale?: string, justNowText?: string, unknownText?: string): string;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdRelativeTimePipe, never>;
+  static ɵpipe: i0.ɵɵPipeDeclaration<VdRelativeTimePipe, "vdRelativeTime", true>;
+}
+export declare class VdRelativeTime {
+  readonly vdRelativeTime: import("@angular/core").InputSignal<number | null | undefined>;
+  readonly now: import("@angular/core").InputSignal<number>;
+  readonly locale: import("@angular/core").InputSignal<string | undefined>;
+  readonly justNowText: import("@angular/core").InputSignal<string | undefined>;
+  readonly unknownText: import("@angular/core").InputSignal<string | undefined>;
+  private readonly texts;
+  private readonly t;
+  protected readonly valid: import("@angular/core").Signal<boolean>;
+  protected readonly datetime: import("@angular/core").Signal<string | null>;
+  protected readonly text: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdRelativeTime, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdRelativeTime, "time[vdRelativeTime]", never, {
+    "vdRelativeTime": {
+      "alias": "vdRelativeTime";
+      "required": false;
+      "isSignal": true;
+    };
+    "now": {
+      "alias": "now";
+      "required": true;
+      "isSignal": true;
+    };
+    "locale": {
+      "alias": "locale";
+      "required": false;
+      "isSignal": true;
+    };
+    "justNowText": {
+      "alias": "justNowText";
+      "required": false;
+      "isSignal": true;
+    };
+    "unknownText": {
+      "alias": "unknownText";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+interface VdRelativeTimeOptions {
+  readonly locale?: string;
+  readonly justNowText?: string;
+  readonly unknownText?: string;
+}
+/** Epoch milliseconds only, constrained to the native time element's four-digit year range. */
+declare function vdRelativeTimeValid(value: number | null | undefined): value is number;
+/** Elapsed-duration labels; callers own the clock and refresh cadence. */
+export declare function vdFormatRelativeTime(value: number | null | undefined, now: number | null | undefined, options?: VdRelativeTimeOptions): string;
+export type { VdRelativeTimeOptions };

package/types/vadem-ui-reorder-list.d.ts

@@ -0,0 +1,120 @@
+import * as i0 from "@angular/core";
+interface VdReorderListItem {
+  readonly id: string;
+  readonly label: string;
+  readonly description?: string;
+}
+interface VdReorderListChange {
+  readonly id: string;
+  readonly fromIndex: number;
+  readonly toIndex: number;
+  readonly method: 'buttons' | 'pointer';
+}
+export declare class VdReorderList {
+  readonly items: import("@angular/core").ModelSignal<readonly VdReorderListItem[]>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  readonly instructions: import("@angular/core").InputSignal<string | undefined>;
+  readonly upText: import("@angular/core").InputSignal<string | undefined>;
+  readonly downText: import("@angular/core").InputSignal<string | undefined>;
+  readonly emptyText: import("@angular/core").InputSignal<string | undefined>;
+  readonly invalidText: import("@angular/core").InputSignal<string | undefined>;
+  readonly movedText: import("@angular/core").InputSignal<((label: string, position: number, total: number) => string) | undefined>;
+  readonly canceledText: import("@angular/core").InputSignal<((label: string) => string) | undefined>;
+  readonly reordered: import("@angular/core").OutputEmitterRef<VdReorderListChange>;
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+    instructions: string;
+    upText: string;
+    downText: string;
+    emptyText: string;
+    invalidText: string;
+    movedText: (label: string, position: number, total: number) => string;
+    canceledText: (label: string) => string;
+  }, "label" | "instructions" | "upText" | "downText" | "emptyText" | "invalidText" | "movedText" | "canceledText">>;
+  protected readonly valid: import("@angular/core").Signal<boolean>;
+  protected readonly instructionsId: string;
+  protected readonly draggingId: import("@angular/core").WritableSignal<string | null>;
+  protected readonly drop: import("@angular/core").WritableSignal<{
+    id: string;
+    edge: "before" | "after";
+  } | null>;
+  protected readonly messages: import("@angular/core").WritableSignal<readonly {
+    serial: number;
+    text: string;
+  }[]>;
+  private readonly host;
+  private drag;
+  private focus;
+  private serial;
+  constructor();
+  protected move(id: string, delta: number): void;
+  private commit;
+  protected start(event: PointerEvent, id: string): void;
+  protected pointerMove(event: PointerEvent): void;
+  protected end(event: PointerEvent): void;
+  protected pointerCancel(event: PointerEvent): void;
+  protected key(event: KeyboardEvent): void;
+  private target;
+  private finish;
+  private announce;
+  private list;
+  private rows;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdReorderList, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdReorderList, "vd-reorder-list", never, {
+    "items": {
+      "alias": "items";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "instructions": {
+      "alias": "instructions";
+      "required": false;
+      "isSignal": true;
+    };
+    "upText": {
+      "alias": "upText";
+      "required": false;
+      "isSignal": true;
+    };
+    "downText": {
+      "alias": "downText";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyText": {
+      "alias": "emptyText";
+      "required": false;
+      "isSignal": true;
+    };
+    "invalidText": {
+      "alias": "invalidText";
+      "required": false;
+      "isSignal": true;
+    };
+    "movedText": {
+      "alias": "movedText";
+      "required": false;
+      "isSignal": true;
+    };
+    "canceledText": {
+      "alias": "canceledText";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "items": "itemsChange";
+    "reordered": "reordered";
+  }, never, never, true, never>;
+}
+export type { VdReorderListChange, VdReorderListItem };

package/types/vadem-ui-scroll-area.d.ts

@@ -0,0 +1,13 @@
+import * as i0 from "@angular/core";
+/** A named native scroll viewport; the browser owns all scrolling and descendant keys. */
+export declare class VdScrollArea {
+  readonly label: import("@angular/core").InputSignal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdScrollArea, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdScrollArea, "[vdScrollArea]", never, {
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}

package/types/vadem-ui-search-input.d.ts

@@ -0,0 +1,58 @@
+import { VdInput } from "@vadem/ui/input";
+import * as i0 from "@angular/core";
+/**
+ * Native `input[type=search]`: value, forms accessor and the `search` event stay native.
+ * Adds consistent Escape-to-clear and a clear action. Spec: specs/search-input.md
+ */
+export declare class VdSearchInput extends VdInput {
+  readonly element: HTMLInputElement;
+  /** Emits after the value was cleared by the button or Escape. */
+  readonly cleared: import("@angular/core").OutputEmitterRef<void>;
+  private readonly document;
+  private readonly hasValue;
+  readonly filled: import("@angular/core").Signal<boolean>;
+  private readonly editable;
+  readonly canClear: import("@angular/core").Signal<boolean>;
+  constructor();
+  protected sync(): void;
+  /** Escape clears a non-empty field; an empty field lets Escape reach outer handlers (dialogs). */
+  protected onEscape(event: Event): void;
+  clear(): void;
+  /** Pointer activation keeps the caret in the field. */
+  preserveFocus(event: MouseEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdSearchInput, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdSearchInput, "input[type=search][vdSearchInput]", ["vdSearchInput"], {}, {
+    "cleared": "cleared";
+  }, never, never, true, never>;
+}
+export declare class VdSearchInputGroup {
+  /** Shows a spinner while results load; the field stays editable. */
+  readonly loading: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly clearLabel: import("@angular/core").InputSignal<string | undefined>;
+  readonly loadingLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    clearLabel: string;
+    loadingLabel: string;
+  }, "clearLabel" | "loadingLabel">>;
+  protected readonly control: import("@angular/core").Signal<VdSearchInput | undefined>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdSearchInputGroup, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdSearchInputGroup, "vd-search-input", never, {
+    "loading": {
+      "alias": "loading";
+      "required": false;
+      "isSignal": true;
+    };
+    "clearLabel": {
+      "alias": "clearLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "loadingLabel": {
+      "alias": "loadingLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["control"], ["input[vdSearchInput]", "[slot=end]"], true, never>;
+}
+export declare const VD_SEARCH_INPUT: readonly [typeof VdSearchInputGroup, typeof VdSearchInput];

package/types/vadem-ui-segmented.d.ts

@@ -0,0 +1,76 @@
+import { ControlValueAccessor } from "@angular/forms";
+import * as i0 from "@angular/core";
+type VdSegmentedSize = 'sm' | 'md';
+/**
+ * Single choice among a few options, shown as a segmented control. Each segment is a native
+ * radio sharing one `name`, so arrow keys, Tab, RTL and form semantics come from the platform.
+ * Spec: specs/segmented.md
+ */
+export declare class VdSegmented implements ControlValueAccessor {
+  /** Selected segment value (two-way). */
+  readonly value: import("@angular/core").ModelSignal<string | null>;
+  readonly size: import("@angular/core").InputSignal<VdSegmentedSize>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Shared radio `name`. */
+  readonly name: string;
+  private readonly formDisabled;
+  readonly isDisabled: import("@angular/core").Signal<boolean>;
+  private onChange;
+  private onTouched;
+  select(value: string): void;
+  protected onFocusOut(event: FocusEvent): void;
+  writeValue(value: string | null): void;
+  registerOnChange(fn: (value: string | null) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(disabled: boolean): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdSegmented, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdSegmented, "vd-segmented", never, {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "value": "valueChange";
+  }, never, ["*"], true, never>;
+}
+/** One option of `vd-segmented`. Icon-only segments need `aria-label`. */
+export declare class VdSegment {
+  readonly value: import("@angular/core").InputSignal<string>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  protected readonly group: VdSegmented;
+  /** The radio isn't inside a <label>; the visible text names it. */
+  protected readonly labelId: string;
+  protected readonly checked: import("@angular/core").Signal<boolean>;
+  protected readonly isDisabled: import("@angular/core").Signal<boolean>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdSegment, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdSegment, "vd-segment", never, {
+    "value": {
+      "alias": "value";
+      "required": true;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+export type { VdSegmentedSize };