@raqm/ui 0.0.0-stage → 0.1.1

package/types/raqm-ui-select.d.ts

@@ -0,0 +1,205 @@
+import { Highlightable } from "@angular/cdk/a11y";
+import { Directionality } from "@angular/cdk/bidi";
+import * as i0 from "@angular/core";
+import { OnDestroy, OnInit } from "@angular/core";
+import { ControlValueAccessor } from "@angular/forms";
+/**
+ * A single selectable option; `null` is legitimate, so a present `null` option can clear the control.
+ * `triggerLabel` is the trigger-only text, while rows and typeahead keep `label`. Values must be
+ * unique (at most one `null`); duplicates report a development error.
+ */
+interface RaqmSelectOption {
+  value: string | null;
+  label: string;
+  triggerLabel?: string;
+  disabled?: boolean;
+}
+/**
+ * A labelled `role="group"`, its label referenced by `aria-labelledby`, above an optional decorative
+ * separator.
+ */
+interface RaqmSelectGroup {
+  label: string;
+  options: readonly RaqmSelectOption[];
+  separatorBefore?: boolean;
+}
+/** A bare option renders as part of an unnamed group; `separatorBefore` is honoured in place. */
+type RaqmSelectEntry = RaqmSelectOption | RaqmSelectGroup;
+declare const OVERLAY_GAP = 4;
+declare const VIEWPORT_MARGIN = 10;
+declare const ANCHOR_CLEARANCE = 9;
+declare const SCROLL_STEP = 120;
+declare const AUTO_SCROLL_INTERVAL_MS = 40;
+declare const SCROLL_EDGE_TOLERANCE_PX = 1;
+interface RaqmSelectOptionView {
+  readonly option: RaqmSelectOption;
+  readonly id: string;
+  readonly index: number;
+}
+interface RaqmSelectChunkView {
+  readonly key: string;
+  readonly label: string | null;
+  readonly labelId: string | null;
+  readonly separatorBefore: boolean;
+  readonly options: RaqmSelectOptionView[];
+}
+declare function isSelectGroup(entry: RaqmSelectEntry): entry is RaqmSelectGroup;
+declare function normalizeValue(value: unknown): string | null;
+declare function resolveSelectDirection(dir: 'ltr' | 'rtl' | undefined, element: HTMLElement, directionality: Directionality | null): 'ltr' | 'rtl';
+declare class RaqmSelectOptionRef implements Highlightable {
+  readonly view: RaqmSelectOptionView;
+  private readonly activate;
+  constructor(view: RaqmSelectOptionView, activate: (ref: RaqmSelectOptionRef) => void);
+  get disabled(): boolean;
+  getLabel(): string;
+  setActiveStyles(): void;
+  setInactiveStyles(): void;
+}
+/**
+ * A single-select popup exposed as an ARIA 1.2 combobox.
+ *
+ * @remarks
+ * The host is not the control: the internal `<button type="button">` carries `role="combobox"` and
+ * the popup is an overlay `role="listbox"` of `role="option"` rows. The host has no role or tab
+ * stop, so an application label must target `inputId`; a supplied `label` renders an internal
+ * `<label [for]>`, and the placeholder never becomes the accessible name. Focus stays on the
+ * trigger via the active-descendant pattern, with a label-only typeahead and no focus trap.
+ * Bind either `[(value)]` or one Forms directive: `writeValue` normalises non-strings to `null` and
+ * never emits nor marks dirty, while a committed selection calls the change callback once.
+ * `alignItemWithTrigger` measures once, so the selected row sits over the trigger.
+ */
+export declare class RaqmSelect implements ControlValueAccessor, OnInit, OnDestroy {
+  private readonly host;
+  private readonly overlay;
+  private readonly viewportRuler;
+  private readonly directionality;
+  private readonly viewContainerRef;
+  private readonly triggerRef;
+  private readonly popupTemplate;
+  private readonly autoId;
+  private readonly injector;
+  readonly items: import("@angular/core").InputSignal<readonly RaqmSelectEntry[]>;
+  readonly value: import("@angular/core").InputSignal<string | null>;
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string | null>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Text shown when no option label matches; app-owned, no default. */
+  readonly placeholder: import("@angular/core").InputSignal<string | null>;
+  /** Aligns the selected row over the trigger. */
+  readonly alignItemWithTrigger: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly dir: import("@angular/core").InputSignal<"ltr" | "rtl" | undefined>;
+  /** Id of the real trigger button; generated when absent. */
+  readonly inputId: import("@angular/core").InputSignal<string>;
+  /** Optional internal label text, rendered as a `<label [for]>`. */
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** External label id(s); takes precedence over `label`. */
+  readonly labelledBy: import("@angular/core").InputSignal<string | undefined>;
+  readonly describedBy: import("@angular/core").InputSignal<string | undefined>;
+  /** Application-owned invalid state; drives `aria-invalid`. */
+  readonly invalid: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly selected: import("@angular/core").WritableSignal<string | null>;
+  private readonly state;
+  readonly resolvedInputId: import("@angular/core").Signal<string>;
+  readonly labelId: import("@angular/core").Signal<string>;
+  /** Id of the popup listbox, referenced by `aria-controls`. */
+  readonly listboxId: import("@angular/core").Signal<string>;
+  readonly chunks: import("@angular/core").Signal<RaqmSelectChunkView[]>;
+  readonly selectedLabel: import("@angular/core").Signal<string | null>;
+  readonly effectiveDisabled: import("@angular/core").Signal<boolean>;
+  readonly open: import("@angular/core").WritableSignal<boolean>;
+  readonly activeId: import("@angular/core").WritableSignal<string | null>;
+  readonly overlayDir: import("@angular/core").WritableSignal<"ltr" | "rtl">;
+  readonly canScrollUp: import("@angular/core").WritableSignal<boolean>;
+  readonly canScrollDown: import("@angular/core").WritableSignal<boolean>;
+  readonly alignmentSide: import("@angular/core").WritableSignal<"none" | "bottom" | "top">;
+  private readonly control;
+  private readonly position;
+  private readonly scrolling;
+  private readonly layer;
+  private readonly keyboard;
+  constructor();
+  ngOnInit(): void;
+  ngOnDestroy(): void;
+  /** Writes an external value without emitting or marking touched; non-strings become `null`. */
+  writeValue(value: unknown): void;
+  registerOnChange(fn: (value: string | null) => void): void;
+  registerOnTouched(fn: () => void): void;
+  /** ORs a Forms disabled state with the explicit input and closes the popup. */
+  setDisabledState(isDisabled: boolean): void;
+  /** Opens the popup when closed, closes it when open. */
+  toggle(): void;
+  /** Handles every trigger key, open or closed. */
+  onTriggerKeydown(event: KeyboardEvent): void;
+  /** Marks the control touched when focus leaves the whole composite. */
+  onTriggerBlur(event: FocusEvent): void;
+  onOptionClick(option: RaqmSelectOption): void;
+  /** Routes hover through the key manager, so paint, `aria-activedescendant` and the active item agree. */
+  onOptionPointerMove(view: RaqmSelectOptionView): void;
+  /** Clears the active option on leaving the list, so the next ArrowDown restarts at the top. */
+  onOptionPointerLeave(event: PointerEvent): void;
+  scrollByStep(direction: 'up' | 'down'): void;
+  startAutoScroll(direction: 'up' | 'down'): void;
+  stopAutoScroll(): void;
+  private openPopup;
+  private close;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSelect, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSelect, "raqm-select", never, {
+    "items": {
+      "alias": "items";
+      "required": true;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "alignItemWithTrigger": {
+      "alias": "alignItemWithTrigger";
+      "required": false;
+      "isSignal": true;
+    };
+    "dir": {
+      "alias": "dir";
+      "required": false;
+      "isSignal": true;
+    };
+    "inputId": {
+      "alias": "inputId";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelledBy": {
+      "alias": "labelledBy";
+      "required": false;
+      "isSignal": true;
+    };
+    "describedBy": {
+      "alias": "describedBy";
+      "required": false;
+      "isSignal": true;
+    };
+    "invalid": {
+      "alias": "invalid";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "valueChange": "valueChange";
+  }, never, never, true, never>;
+}
+export type { RaqmSelectEntry, RaqmSelectGroup, RaqmSelectOption };

package/types/raqm-ui-separator.d.ts

@@ -0,0 +1,21 @@
+import * as i0 from "@angular/core";
+/** Raqm separator — a one-pixel semantic divider; neither axis attribute means horizontal. */
+export declare class RaqmSeparator {
+  readonly horizontal: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly vertical: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** The resolved axis; setting both attributes throws. */
+  protected readonly orientation: import("@angular/core").Signal<"horizontal" | "vertical">;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSeparator, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSeparator, "raqm-separator", never, {
+    "horizontal": {
+      "alias": "horizontal";
+      "required": false;
+      "isSignal": true;
+    };
+    "vertical": {
+      "alias": "vertical";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}

package/types/raqm-ui-sheet.d.ts

@@ -0,0 +1,79 @@
+import * as i1 from "@raqm/ui/dialog";
+import { RaqmDialogBaseComponent, RaqmDialogContentDirective, RaqmDialogTriggerDirective } from "@raqm/ui/dialog";
+import * as i0 from "@angular/core";
+/** Edge modal sharing Dialog's stack, focus trap, scroll lock and teardown. */
+export declare class RaqmSheetComponent extends RaqmDialogBaseComponent {
+  /** The edge the sheet is attached to; right/left are logical in RTL. */
+  readonly side: import("@angular/core").InputSignal<"top" | "right" | "bottom" | "left">;
+  readonly showCloseButton: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly closeLabel: import("@angular/core").InputSignal<string | undefined>;
+  protected readonly closeButtonVisible: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  protected readonly closeLabelText: import("@angular/core").InputSignal<string | undefined>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSheetComponent, "raqm-sheet", ["raqmSheet"], {
+    "side": {
+      "alias": "side";
+      "required": false;
+      "isSignal": true;
+    };
+    "showCloseButton": {
+      "alias": "showCloseButton";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeLabel": {
+      "alias": "closeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/** Native opener reusing Dialog registration and disclosure ARIA; compose raqm-button. */
+export declare class RaqmSheetTriggerDirective extends RaqmDialogTriggerDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetTriggerDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetTriggerDirective, "button[raqm-sheet-trigger]", never, {}, {}, never, never, true, never>;
+}
+/** Native close control using Dialog's single animated user-close path. */
+export declare class RaqmSheetCloseDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetCloseDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetCloseDirective, "button[raqm-sheet-close]", never, {}, {}, never, never, true, [{
+    directive: typeof i1.RaqmDialogCloseDirective;
+    inputs: {};
+    outputs: {};
+  }]>;
+}
+/** Portal body template; the root owns edge placement and the close control. */
+export declare class RaqmSheetContentDirective extends RaqmDialogContentDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetContentDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetContentDirective, "ng-template[raqm-sheet-content]", ["raqmSheetContent"], {}, {}, never, never, true, never>;
+}
+/** Passive header, stacking the title and description. */
+export declare class RaqmSheetHeaderDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetHeaderDirective, "[raqm-sheet-header]", never, {}, {}, never, never, true, never>;
+}
+/** Passive action footer, pushed to the end of the Sheet surface. */
+export declare class RaqmSheetFooterDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetFooterDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetFooterDirective, "[raqm-sheet-footer]", never, {}, {}, never, never, true, never>;
+}
+/** Accessible title registered with the real modal container. */
+export declare class RaqmSheetTitleDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetTitleDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetTitleDirective, "[raqm-sheet-title]", never, {}, {}, never, never, true, [{
+    directive: typeof i1.RaqmDialogTitleDirective;
+    inputs: {};
+    outputs: {};
+  }]>;
+}
+/** Accessible description registered with the real modal container. */
+export declare class RaqmSheetDescriptionDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSheetDescriptionDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSheetDescriptionDirective, "[raqm-sheet-description]", never, {}, {}, never, never, true, [{
+    directive: typeof i1.RaqmDialogDescriptionDirective;
+    inputs: {};
+    outputs: {};
+  }]>;
+}
+export declare const RaqmSheet: readonly [typeof RaqmSheetComponent, typeof RaqmSheetTriggerDirective, typeof RaqmSheetCloseDirective, typeof RaqmSheetContentDirective, typeof RaqmSheetHeaderDirective, typeof RaqmSheetFooterDirective, typeof RaqmSheetTitleDirective, typeof RaqmSheetDescriptionDirective];

package/types/raqm-ui-sidebar.d.ts

@@ -0,0 +1,285 @@
+import * as i0 from "@angular/core";
+import { InjectionToken, Signal } from "@angular/core";
+import * as i1 from "@raqm/ui/input";
+export declare class RaqmSidebarComponent {
+  readonly context: import("@raqm/ui/sidebar").RaqmSidebarContext;
+  readonly side: import("@angular/core").InputSignal<"right" | "left">;
+  readonly variant: import("@angular/core").InputSignal<"sidebar" | "floating" | "inset">;
+  readonly collapsible: import("@angular/core").InputSignal<"offcanvas" | "icon" | "none">;
+  readonly dir: import("@angular/core").InputSignal<"ltr" | "rtl" | undefined>;
+  /** The mobile sheet's accessible name and visible title; application-supplied. */
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  readonly description: import("@angular/core").InputSignal<string | undefined>;
+  constructor();
+  protected onMobileKeydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSidebarComponent, "raqm-sidebar", never, {
+    "side": {
+      "alias": "side";
+      "required": false;
+      "isSignal": true;
+    };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "collapsible": {
+      "alias": "collapsible";
+      "required": false;
+      "isSignal": true;
+    };
+    "dir": {
+      "alias": "dir";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "description": {
+      "alias": "description";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*", "[raqm-sidebar-rail]"], true, never>;
+}
+export declare class RaqmSidebarHeaderDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarHeaderDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarHeaderDirective, "[raqm-sidebar-header]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarFooterDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarFooterDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarFooterDirective, "[raqm-sidebar-footer]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarContentDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarContentDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarContentDirective, "[raqm-sidebar-content]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarGroupDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarGroupDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarGroupDirective, "[raqm-sidebar-group]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarGroupLabelDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarGroupLabelDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarGroupLabelDirective, "[raqm-sidebar-group-label]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarGroupContentDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarGroupContentDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarGroupContentDirective, "[raqm-sidebar-group-content]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarGroupActionDirective {
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarGroupActionDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarGroupActionDirective, "button[raqm-sidebar-group-action]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuDirective, "ul[raqm-sidebar-menu]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuItemDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuItemDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuItemDirective, "li[raqm-sidebar-menu-item]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuSubDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuSubDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuSubDirective, "ul[raqm-sidebar-menu-sub]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuSubItemDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuSubItemDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuSubItemDirective, "li[raqm-sidebar-menu-sub-item]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuBadgeDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuBadgeDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuBadgeDirective, "[raqm-sidebar-menu-badge]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarInsetDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarInsetDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarInsetDirective, "main[raqm-sidebar-inset]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarInputDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarInputDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarInputDirective, "input[raqm-sidebar-input]", never, {}, {}, never, never, true, [{
+    directive: typeof i1.RaqmInput;
+    inputs: {};
+    outputs: {};
+  }]>;
+}
+/** Separator part; keeps the shipped raqm-separator's semantic orientation. */
+export declare class RaqmSidebarSeparatorDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarSeparatorDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarSeparatorDirective, "raqm-separator[raqm-sidebar-separator]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuActionDirective {
+  readonly showOnHover: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuActionDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuActionDirective, "button[raqm-sidebar-menu-action]", never, {
+    "showOnHover": {
+      "alias": "showOnHover";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Native button/anchor host; routerLink and menu directives compose on it directly. */
+export declare class RaqmSidebarMenuButtonComponent {
+  /** Bare or empty marker uses the default appearance. */
+  readonly appearance: import("@angular/core").InputSignal<"" | "default" | "outline">;
+  readonly small: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly large: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly active: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  protected readonly activeVariant: import("@angular/core").Signal<"default" | "outline">;
+  protected readonly activeSize: import("@angular/core").Signal<"sm" | "lg" | null>;
+  readonly tooltip: import("@angular/core").InputSignal<string | RaqmSidebarTooltip | undefined>;
+  private readonly context;
+  private readonly host;
+  private readonly tip;
+  protected readonly tooltipText: import("@angular/core").Signal<string>;
+  protected readonly tooltipSide: import("@angular/core").Signal<"top" | "right" | "bottom" | "left">;
+  protected readonly tooltipAlign: import("@angular/core").Signal<"start" | "center" | "end">;
+  protected readonly tooltipOffset: import("@angular/core").Signal<number>;
+  protected readonly showTooltip: import("@angular/core").Signal<boolean>;
+  private readonly ref;
+  constructor();
+  protected pointer(event: Event, entering: boolean): void;
+  protected focus(entering: boolean): void;
+  protected dismiss(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuButtonComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSidebarMenuButtonComponent, "button[raqm-sidebar-menu-button], a[raqm-sidebar-menu-button]", never, {
+    "appearance": {
+      "alias": "raqm-sidebar-menu-button";
+      "required": false;
+      "isSignal": true;
+    };
+    "small": {
+      "alias": "small";
+      "required": false;
+      "isSignal": true;
+    };
+    "large": {
+      "alias": "large";
+      "required": false;
+      "isSignal": true;
+    };
+    "active": {
+      "alias": "active";
+      "required": false;
+      "isSignal": true;
+    };
+    "tooltip": {
+      "alias": "tooltip";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+interface RaqmSidebarTooltip {
+  text: string;
+  side?: 'top' | 'right' | 'bottom' | 'left';
+  align?: 'start' | 'center' | 'end';
+  sideOffset?: number;
+  hidden?: boolean;
+}
+export declare class RaqmSidebarMenuSubButtonDirective {
+  readonly small: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly active: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuSubButtonDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarMenuSubButtonDirective, "a[raqm-sidebar-menu-sub-button], button[raqm-sidebar-menu-sub-button]", never, {
+    "small": {
+      "alias": "small";
+      "required": false;
+      "isSignal": true;
+    };
+    "active": {
+      "alias": "active";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarTriggerComponent {
+  private readonly context;
+  constructor();
+  protected toggle(event: MouseEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarTriggerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSidebarTriggerComponent, "button[raqm-sidebar-trigger]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarRailDirective {
+  protected readonly context: import("@raqm/ui/sidebar").RaqmSidebarContext;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarRailDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmSidebarRailDirective, "button[raqm-sidebar-rail]", never, {}, {}, never, never, true, never>;
+}
+export declare class RaqmSidebarMenuSkeletonComponent {
+  readonly showIcon: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarMenuSkeletonComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSidebarMenuSkeletonComponent, "raqm-sidebar-menu-skeleton", never, {
+    "showIcon": {
+      "alias": "showIcon";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Nearest provider's reactive state; readable only in an injection context. */
+interface RaqmSidebarContext {
+  readonly open: Signal<boolean>;
+  readonly openMobile: Signal<boolean>;
+  readonly mobile: Signal<boolean>;
+  readonly state: Signal<'expanded' | 'collapsed'>;
+  setOpen(value: boolean | ((open: boolean) => boolean)): void;
+  setOpenMobile(value: boolean | ((open: boolean) => boolean)): void;
+  toggleSidebar(): void;
+}
+export declare const RAQM_SIDEBAR: InjectionToken<RaqmSidebarContext>;
+export declare function useSidebar(): RaqmSidebarContext;
+/** Provider-scoped state; the shortcut toggles only this provider and cookies are write-only. */
+export declare class RaqmSidebarProviderComponent implements RaqmSidebarContext {
+  readonly defaultOpen: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly openInput: import("@angular/core").InputSignal<boolean | undefined>;
+  readonly openMobileInput: import("@angular/core").InputSignal<boolean | undefined>;
+  readonly openChange: import("@angular/core").OutputEmitterRef<boolean>;
+  readonly openMobileChange: import("@angular/core").OutputEmitterRef<boolean>;
+  private readonly desktop;
+  private readonly mobileOpen;
+  private readonly mobileState;
+  readonly open: import("@angular/core").Signal<boolean>;
+  readonly openMobile: import("@angular/core").Signal<boolean>;
+  readonly mobile: import("@angular/core").Signal<boolean>;
+  readonly state: import("@angular/core").Signal<"expanded" | "collapsed">;
+  private readonly document;
+  private readonly host;
+  private readonly destroy;
+  constructor();
+  setOpen(value: boolean | ((open: boolean) => boolean)): void;
+  setOpenMobile(value: boolean | ((open: boolean) => boolean)): void;
+  toggleSidebar(): void;
+  protected onKeydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSidebarProviderComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSidebarProviderComponent, "raqm-sidebar-provider", ["raqmSidebarProvider"], {
+    "defaultOpen": {
+      "alias": "defaultOpen";
+      "required": false;
+      "isSignal": true;
+    };
+    "openInput": {
+      "alias": "open";
+      "required": false;
+      "isSignal": true;
+    };
+    "openMobileInput": {
+      "alias": "openMobile";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "openChange": "openChange";
+    "openMobileChange": "openMobileChange";
+  }, never, ["*"], true, never>;
+}
+export declare const RaqmSidebar: readonly [typeof RaqmSidebarProviderComponent, typeof RaqmSidebarComponent, typeof RaqmSidebarTriggerComponent, typeof RaqmSidebarRailDirective, typeof RaqmSidebarInsetDirective, typeof RaqmSidebarInputDirective, typeof RaqmSidebarHeaderDirective, typeof RaqmSidebarFooterDirective, typeof RaqmSidebarSeparatorDirective, typeof RaqmSidebarContentDirective, typeof RaqmSidebarGroupDirective, typeof RaqmSidebarGroupLabelDirective, typeof RaqmSidebarGroupActionDirective, typeof RaqmSidebarGroupContentDirective, typeof RaqmSidebarMenuDirective, typeof RaqmSidebarMenuItemDirective, typeof RaqmSidebarMenuButtonComponent, typeof RaqmSidebarMenuActionDirective, typeof RaqmSidebarMenuBadgeDirective, typeof RaqmSidebarMenuSkeletonComponent, typeof RaqmSidebarMenuSubDirective, typeof RaqmSidebarMenuSubItemDirective, typeof RaqmSidebarMenuSubButtonDirective];
+export type { RaqmSidebarContext, RaqmSidebarTooltip };

package/types/raqm-ui-skeleton.d.ts

@@ -0,0 +1,6 @@
+import * as i0 from "@angular/core";
+/** Raqm skeleton — a decorative loading placeholder; the host is `aria-hidden` with no role or tab stop. */
+export declare class RaqmSkeleton {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmSkeleton, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmSkeleton, "raqm-skeleton", never, {}, {}, never, ["*"], true, never>;
+}