@akcelik/strct 0.29.0 → 0.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akcelik/strct",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "UIStruct — a standalone Angular component library with a tokenised, multi-palette theme system, built for datacenter / infrastructure management UIs.",
   "author": "Serkan Akcelik <serkan.akcelik@gmail.com>",
   "license": "MIT",
@@ -32,7 +32,8 @@
     "@angular/common": "^21.2.0",
     "@angular/core": "^21.2.0",
     "@angular/forms": "^21.2.0",
-    "@angular/platform-browser": "^21.2.0"
+    "@angular/platform-browser": "^21.2.0",
+    "@angular/router": "^21.2.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"

package/types/akcelik-strct.d.ts

@@ -247,6 +247,22 @@ interface StrctRailItem {
     /** Badge colour (defaults to `accent`). When collapsed it renders as a dot. */
     badgeStatus?: StrctRailStatus;
     disabled?: boolean;
+    /** `'bottom'` pins the item to the foot of the rail (e.g. Administration). */
+    placement?: 'top' | 'bottom';
+    /**
+     * Render as a real router link (`<a routerLink>`): middle-click, ⌘/Ctrl-click
+     * and "open in new tab" work; `(select)` still fires on plain activation.
+     * When neither `routerLink` nor `href` is set the item stays a `<button>`.
+     */
+    routerLink?: string | unknown[];
+    /** Render as a plain `<a href>` (external or non-router destinations). */
+    href?: string;
+    /** Small trailing status dot with no text (e.g. "unsaved changes"). */
+    dot?: boolean;
+    /** Dot tone; defaults to `accent`. */
+    dotStatus?: StrctRailStatus;
+    /** Muted trailing icon (e.g. "restart required"), before any badge / dot. */
+    trailingIcon?: string;
 }
 /**
  * Collapsible, data-driven primary navigation rail for an application shell.
@@ -269,7 +285,16 @@ declare class StrctRail {
     readonly ariaLabel: _angular_core.InputSignal<string>;
     /** Emitted when an item is chosen. */
     readonly select: _angular_core.OutputEmitterRef<StrctRailItem>;
-    protected pick(item: StrctRailItem): void;
+    protected readonly topItems: _angular_core.Signal<StrctRailItem[]>;
+    protected readonly bottomItems: _angular_core.Signal<StrctRailItem[]>;
+    /** Enabled item with a router destination → renders as `<a routerLink>`. */
+    protected isRouted(item: StrctRailItem): boolean;
+    /**
+     * Active state of a router-link item: an explicit `activeId` is authoritative;
+     * without one, the router's own active state drives it.
+     */
+    protected isActive(item: StrctRailItem, routerActive: boolean): boolean;
+    protected pick(item: StrctRailItem, event?: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StrctRail, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StrctRail, "strct-rail", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "activeId": { "alias": "activeId"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "activeId": "activeIdChange"; "collapsed": "collapsedChange"; "select": "select"; }, never, never, true, never>;
 }
@@ -1111,6 +1136,16 @@ interface StrctMenuLink {
     /** Optional leading icon name. */
     icon?: string;
     disabled?: boolean;
+    /** Trailing count/label chip (e.g. a deviation count). */
+    badge?: string | number;
+    /** Badge tone; defaults to `accent` (shared vocabulary with {@link StrctRailItem}). */
+    badgeStatus?: StrctRailStatus;
+    /** Small trailing status dot with no text (e.g. "unsaved changes"). */
+    dot?: boolean;
+    /** Dot tone; defaults to `accent`. */
+    dotStatus?: StrctRailStatus;
+    /** Muted trailing icon (e.g. "restart required"), before any badge / dot. */
+    trailingIcon?: string;
 }
 /** A category (level 1) that groups {@link StrctMenuLink} items (level 2). */
 interface StrctMenuSection {