@vadem/ui 0.0.0-stage → 0.0.1

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

@@ -0,0 +1,54 @@
+import * as i0 from "@angular/core";
+type VdTimelineStatus = 'neutral' | 'success' | 'warning' | 'danger' | 'info';
+/** Named chronological list; consumers own ordering and timestamps. */
+export declare class VdTimeline {
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+  }, "label">>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTimeline, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTimeline, "ol[vdTimeline]", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Native list item with a decorative marker and visible localized status text. */
+export declare class VdTimelineItem {
+  readonly status: import("@angular/core").InputSignal<VdTimelineStatus>;
+  readonly statusLabel: import("@angular/core").InputSignal<string | undefined>;
+  protected readonly icon: import("@angular/core").Signal<"info" | "activity" | "alert-circle" | "alert-triangle" | "arrow-down" | "arrow-left" | "arrow-right" | "arrow-up" | "arrow-up-down" | "bell" | "calendar" | "check" | "check-circle" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up" | "copy" | "credit-card" | "download" | "external-link" | "eye" | "eye-off" | "file" | "folder" | "git-branch" | "globe" | "key" | "layout-dashboard" | "loader" | "lock" | "log-out" | "mail" | "menu" | "minus" | "monitor" | "moon" | "more-horizontal" | "panel-left" | "pencil" | "plus" | "rocket" | "search" | "settings" | "shield" | "star" | "sun" | "trash" | "trending-down" | "trending-up" | "upload" | "user" | "users" | "x" | "x-circle" | null>;
+  protected readonly resolvedLabel: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTimelineItem, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdTimelineItem, "li[vdTimelineItem]", never, {
+    "status": {
+      "alias": "status";
+      "required": false;
+      "isSignal": true;
+    };
+    "statusLabel": {
+      "alias": "statusLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["[vdTimelineTime]", "[vdTimelineTitle]", "[vdTimelineDescription]", "*"], true, never>;
+}
+/** Keep the consumer's heading level and any native link semantics. */
+export declare class VdTimelineTitle {
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTimelineTitle, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTimelineTitle, "[vdTimelineTitle]", never, {}, {}, never, never, true, never>;
+}
+export declare class VdTimelineDescription {
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTimelineDescription, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTimelineDescription, "[vdTimelineDescription]", never, {}, {}, never, never, true, never>;
+}
+/** Native datetime and localized text are supplied by the consumer. */
+export declare class VdTimelineTime {
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTimelineTime, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTimelineTime, "time[vdTimelineTime]", never, {}, {}, never, never, true, never>;
+}
+export declare const VD_TIMELINE: readonly [typeof VdTimeline, typeof VdTimelineItem, typeof VdTimelineTitle, typeof VdTimelineDescription, typeof VdTimelineTime];
+export type { VdTimelineStatus };

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

@@ -0,0 +1,104 @@
+import * as i0 from "@angular/core";
+/**
+ * Framework-agnostic toast queue: ids, auto-dismiss timers that pause while the user is
+ * interacting (hover/focus), a cap on visible toasts, and a two-phase exit ("leaving" for the
+ * exit animation, then removed). Adapters subscribe and render.
+ */
+type VdToastVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'info';
+interface VdToastAction {
+  label: string;
+  onClick: () => void;
+}
+interface VdToastInput {
+  title: string;
+  description?: string;
+  variant?: VdToastVariant;
+  action?: VdToastAction;
+  /** Auto-dismiss after ms. `Infinity` keeps it until dismissed. Default depends on content. */
+  duration?: number;
+}
+interface VdToast extends Required<Pick<VdToastInput, 'title' | 'variant'>> {
+  id: number;
+  description?: string;
+  action?: VdToastAction;
+  duration: number;
+  state: 'open' | 'leaving';
+}
+interface VdToastStoreOptions {
+  /** Max toasts shown at once; older ones leave first. */
+  max: number;
+  /** Default lifetime, ms. Toasts with an action get double, giving time to reach it. */
+  duration: number;
+  /** How long the exit animation may take before removal, ms. */
+  exitDuration: number;
+}
+export declare const VD_TOAST_DEFAULTS: VdToastStoreOptions;
+export declare class VdToastStore {
+  private readonly options;
+  private toasts;
+  private readonly timers;
+  private readonly listeners;
+  private nextId;
+  private paused;
+  constructor(options?: VdToastStoreOptions);
+  get snapshot(): readonly VdToast[];
+  subscribe(listener: (toasts: readonly VdToast[]) => void): () => void;
+  show(input: VdToastInput): number;
+  /** Starts the exit; the toast is removed after the exit animation (or `exitDuration`). */
+  dismiss(id: number): void;
+  /** Removes immediately (call when the exit animation has ended). */
+  remove(id: number): void;
+  dismissAll(): void;
+  /** Pause every timer (pointer or focus inside the toaster - WCAG 2.2.1). */
+  pause(): void;
+  resume(): void;
+  destroy(): void;
+  private startTimer;
+  private run;
+  private clearTimer;
+  private emit;
+}
+/** App-wide toast queue. Render it once with `<vd-toaster />`. Spec: specs/toast.md */
+export declare class VdToaster {
+  readonly store: VdToastStore;
+  private readonly list;
+  readonly toasts: import("@angular/core").Signal<readonly VdToast[]>;
+  constructor();
+  show(toast: VdToastInput): number;
+  success(title: string, description?: string): number;
+  error(title: string, description?: string): number;
+  dismiss(id: number): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToaster, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+export declare class VdToasterOutlet {
+  /** Landmark name for the region (localize it). */
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  readonly closeLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+    closeLabel: string;
+  }, "label" | "closeLabel">>;
+  protected readonly toaster: VdToaster;
+  protected readonly icons: Partial<Record<VdToastVariant, "info" | "activity" | "alert-circle" | "alert-triangle" | "arrow-down" | "arrow-left" | "arrow-right" | "arrow-up" | "arrow-up-down" | "bell" | "calendar" | "check" | "check-circle" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up" | "copy" | "credit-card" | "download" | "external-link" | "eye" | "eye-off" | "file" | "folder" | "git-branch" | "globe" | "key" | "layout-dashboard" | "loader" | "lock" | "log-out" | "mail" | "menu" | "minus" | "monitor" | "moon" | "more-horizontal" | "panel-left" | "pencil" | "plus" | "rocket" | "search" | "settings" | "shield" | "star" | "sun" | "trash" | "trending-down" | "trending-up" | "upload" | "user" | "users" | "x" | "x-circle">>;
+  private readonly el;
+  private readonly hasToasts;
+  constructor();
+  protected resumeUnlessFocused(): void;
+  protected resumeIfLeaving(event: FocusEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToasterOutlet, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdToasterOutlet, "vd-toaster", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeLabel": {
+      "alias": "closeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type { VdToast, VdToastAction, VdToastInput, VdToastStoreOptions, VdToastVariant };

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

@@ -0,0 +1,80 @@
+import { VdOrientation } from "@vadem/ui/keyboard";
+import * as i0 from "@angular/core";
+interface ToolbarSnapshot {
+  items: readonly VdToolbarItem[];
+  unavailable: readonly boolean[];
+}
+/** A single keyboard stop for related button actions; consumers own activation. */
+export declare class VdToolbar {
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+  }, "label">>;
+  readonly orientation: import("@angular/core").InputSignal<VdOrientation>;
+  readonly element: HTMLElement;
+  private readonly document;
+  private readonly descendants;
+  readonly snapshot: import("@angular/core").Signal<ToolbarSnapshot>;
+  readonly active: import("@angular/core").WritableSignal<VdToolbarItem | null>;
+  private lastFocused;
+  constructor();
+  remember(item: VdToolbarItem): void;
+  protected onFocusOut(event: FocusEvent): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToolbar, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdToolbar, "[vdToolbar]", ["vdToolbar"], {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "orientation": {
+      "alias": "orientation";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["descendants"], never, true, never>;
+}
+/** Add beside vdButton; native Enter/Space, disabled/loading and click actions stay with Button. */
+export declare class VdToolbarItem {
+  readonly hidden: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly toolbar: VdToolbar;
+  readonly element: HTMLButtonElement;
+  private readonly button;
+  private readonly group;
+  readonly unavailable: import("@angular/core").Signal<boolean>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToolbarItem, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdToolbarItem, "button[vdButton][vdToolbarItem]", never, {
+    "hidden": {
+      "alias": "hidden";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export declare class VdToolbarGroup {
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly hidden: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly toolbar: VdToolbar;
+  readonly parent: VdToolbarGroup | null;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToolbarGroup, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdToolbarGroup, "[vdToolbarGroup]", never, {
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "hidden": {
+      "alias": "hidden";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export declare class VdToolbarSeparator {
+  protected readonly toolbar: VdToolbar;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdToolbarSeparator, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdToolbarSeparator, "[vdToolbarSeparator]", never, {}, {}, never, never, true, never>;
+}
+export declare const VD_TOOLBAR: readonly [typeof VdToolbar, typeof VdToolbarItem, typeof VdToolbarGroup, typeof VdToolbarSeparator];

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

@@ -0,0 +1,71 @@
+import * as i0 from "@angular/core";
+type VdTooltipPlacement = 'top' | 'bottom' | 'start' | 'end';
+/**
+ * Short plain-text tooltip on hover and keyboard focus. Rendered as a `popover="manual"`
+ * element in the top layer and positioned with CSS anchor positioning. Spec: specs/tooltip.md
+ */
+export declare class VdTooltip {
+  readonly vdTooltip: import("@angular/core").InputSignal<string>;
+  readonly vdTooltipPlacement: import("@angular/core").InputSignal<VdTooltipPlacement>;
+  readonly vdTooltipDelay: import("@angular/core").InputSignalWithTransform<number, unknown>;
+  private readonly el;
+  private readonly id;
+  private readonly tip;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTooltip, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTooltip, "[vdTooltip]", never, {
+    "vdTooltip": {
+      "alias": "vdTooltip";
+      "required": true;
+      "isSignal": true;
+    };
+    "vdTooltipPlacement": {
+      "alias": "vdTooltipPlacement";
+      "required": false;
+      "isSignal": true;
+    };
+    "vdTooltipDelay": {
+      "alias": "vdTooltipDelay";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * Framework-agnostic tooltip behavior for a trigger + a `popover="manual"` element:
+ * - hover shows after a delay (instantly while another tooltip was just open: "warm" state),
+ *   keyboard focus (:focus-visible) shows immediately;
+ * - the tooltip itself is hoverable, so the pointer can move onto it (WCAG 1.4.13);
+ * - Escape hides it without moving focus; touch input never shows it.
+ */
+interface VdTooltipControllerOptions {
+  /** Hover delay before showing, ms. */
+  showDelay: number;
+  /** Grace period after the pointer leaves, ms. */
+  hideDelay: number;
+}
+export declare const VD_TOOLTIP_DEFAULTS: VdTooltipControllerOptions;
+export declare class VdTooltipController {
+  private readonly trigger;
+  private readonly tooltip;
+  private readonly options;
+  private showTimer;
+  private hideTimer;
+  private hovering;
+  private focused;
+  constructor(trigger: HTMLElement, tooltip: HTMLElement, options?: VdTooltipControllerOptions);
+  get isOpen(): boolean;
+  show(): void;
+  hide(): void;
+  destroy(): void;
+  private readonly onEnter;
+  private readonly onLeave;
+  private readonly onFocusIn;
+  private readonly onFocusOut;
+  /** Pressing the trigger acts on it; the tooltip gets out of the way. */
+  private readonly onPress;
+  private readonly onKeydown;
+}
+/** Test helper: reset the shared warm-up state. */
+export declare function vdResetTooltipWarmth(): void;
+export type { VdTooltipControllerOptions, VdTooltipPlacement };

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

@@ -0,0 +1,123 @@
+import * as i0 from "@angular/core";
+interface VdTreeNode {
+  key: string;
+  parent: string | null;
+  expanded: boolean;
+  disabled: boolean;
+}
+/** Preorder visibility from a mounted hierarchy; collapsed ancestors hide descendants. */
+declare function vdTreeVisible(nodes: readonly VdTreeNode[]): VdTreeNode[];
+/** Prefer the current node or its closest visible ancestor, then selection or first node. */
+declare function vdTreeFocusKey(nodes: readonly VdTreeNode[], current: string | null, selected: string | null): string | null;
+type VdTreeAction = {
+  type: 'focus';
+  key: string;
+} | {
+  type: 'expand';
+  key: string;
+  expanded: boolean;
+} | {
+  type: 'select';
+  key: string;
+};
+/** RTL mirrors branch keys; disabled nodes are focusable but cannot be activated. */
+declare function vdTreeAction(key: string, current: string, nodes: readonly VdTreeNode[], rtl?: boolean): VdTreeAction | null;
+export declare class VdTree {
+  readonly value: import("@angular/core").ModelSignal<string | null>;
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+  }, "label">>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly element: HTMLElement;
+  private readonly document;
+  private readonly injector;
+  private readonly descendants;
+  readonly items: import("@angular/core").Signal<VdTreeItem[]>;
+  readonly nodes: import("@angular/core").Signal<{
+    key: string;
+    parent: string | null;
+    expanded: boolean;
+    disabled: boolean;
+  }[]>;
+  readonly visible: import("@angular/core").Signal<VdTreeNode[]>;
+  readonly focused: import("@angular/core").WritableSignal<string | null>;
+  private readonly typeahead;
+  private lastFocused;
+  constructor();
+  focus(key: string): void;
+  remember(item: VdTreeItem): void;
+  select(item: VdTreeItem): void;
+  toggle(item: VdTreeItem): void;
+  protected onFocusOut(event: FocusEvent): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTree, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTree, "ul[vdTree]", ["vdTree"], {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "value": "valueChange";
+  }, ["descendants"], never, true, never>;
+}
+export declare class VdTreeItem {
+  readonly value: import("@angular/core").InputSignal<string>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly expanded: import("@angular/core").ModelSignal<boolean>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly tree: VdTree;
+  readonly parent: VdTreeItem | null;
+  readonly element: HTMLElement;
+  readonly branch: import("@angular/core").Signal<boolean>;
+  protected readonly labelId: string;
+  protected readonly selected: import("@angular/core").Signal<boolean>;
+  protected readonly isDisabled: import("@angular/core").Signal<boolean>;
+  protected readonly siblings: import("@angular/core").Signal<VdTreeItem[]>;
+  protected readonly position: import("@angular/core").Signal<number>;
+  readonly level: import("@angular/core").Signal<number>;
+  protected onClick(event: MouseEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTreeItem, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdTreeItem, "li[vdTreeItem]", ["vdTreeItem"], {
+    "value": {
+      "alias": "value";
+      "required": true;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "expanded": {
+      "alias": "expanded";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "expanded": "expandedChange";
+  }, never, ["*"], true, never>;
+}
+export declare class VdTreeGroup {
+  protected readonly parent: VdTreeItem;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdTreeGroup, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<VdTreeGroup, "ul[vdTreeGroup]", never, {}, {}, never, never, true, never>;
+}
+export declare const VD_TREE: readonly [typeof VdTree, typeof VdTreeItem, typeof VdTreeGroup];

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

@@ -0,0 +1,70 @@
+import * as i0 from "@angular/core";
+type VdUploadStatus = 'queued' | 'uploading' | 'success' | 'error' | 'canceled';
+interface VdUploadFile {
+  readonly id: string;
+  readonly name: string;
+  readonly status: VdUploadStatus;
+  readonly sizeText?: string;
+  readonly size?: number | null;
+  readonly progress?: number | null;
+  readonly message?: string;
+}
+interface VdUploadListLabels {
+  readonly status: Readonly<Record<VdUploadStatus, string>>;
+  readonly cancel: string;
+  readonly retry: string;
+  readonly remove: string;
+  readonly empty: string;
+}
+/** Controlled upload presentation. Consumers own requests and state transitions. */
+export declare class VdUploadList {
+  readonly files: import("@angular/core").InputSignal<readonly VdUploadFile[]>;
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** Text inputs resolved against the active VD_LOCALE. */
+  protected readonly t: import("@angular/core").Signal<Pick<{
+    label: string;
+  }, "label">>;
+  readonly labels: import("@angular/core").InputSignal<VdUploadListLabels>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly fileCancel: import("@angular/core").OutputEmitterRef<string>;
+  readonly fileRetry: import("@angular/core").OutputEmitterRef<string>;
+  readonly fileRemove: import("@angular/core").OutputEmitterRef<string>;
+  private readonly el;
+  private focusedAction;
+  private focusedIndex;
+  constructor();
+  protected progressValue(file: VdUploadFile): number | null;
+  protected canRetry(file: VdUploadFile): boolean;
+  protected actionLabel(file: VdUploadFile): string;
+  protected rememberFocus(event: FocusEvent, index: number): void;
+  protected act(file: VdUploadFile): void;
+  protected remove(file: VdUploadFile): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<VdUploadList, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<VdUploadList, "ul[vdUploadList]", never, {
+    "files": {
+      "alias": "files";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "labels": {
+      "alias": "labels";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "fileCancel": "fileCancel";
+    "fileRetry": "fileRetry";
+    "fileRemove": "fileRemove";
+  }, never, never, true, never>;
+}
+export type { VdUploadFile, VdUploadListLabels, VdUploadStatus };

package/types/vadem-ui.d.ts

@@ -0,0 +1 @@
+export declare const VD_VERSION = "0.0.1";