@ojiepermana/angular 22.2.3 → 22.2.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. package/fesm2022/{ojiepermana-angular-navigation-navigation-badge-count.component-4RIokl1C.mjs → ojiepermana-angular-navigation-navigation-badge-count.component-BYN_Vxm3.mjs} +36 -5
  2. package/fesm2022/{ojiepermana-angular-navigation-navigation-dockbar-menu.component-I-ln7fOq.mjs → ojiepermana-angular-navigation-navigation-dockbar-menu.component-Dlyt6eZr.mjs} +47 -34
  3. package/fesm2022/{ojiepermana-angular-navigation-navigation-entry-grid.component-meQb_EWZ.mjs → ojiepermana-angular-navigation-navigation-entry-grid.component-DeF_s1vE.mjs} +35 -20
  4. package/fesm2022/{ojiepermana-angular-navigation-navigation-flyout-menu.component-DRdw2G-c.mjs → ojiepermana-angular-navigation-navigation-flyout-menu.component-BOGL8MY0.mjs} +23 -4
  5. package/fesm2022/{ojiepermana-angular-navigation-navigation-horizontal.component-Bx1NcrWO.mjs → ojiepermana-angular-navigation-navigation-horizontal.component-Cb4bHM58.mjs} +29 -4
  6. package/fesm2022/{ojiepermana-angular-navigation-navigation-item.component-ERZNpmTZ.mjs → ojiepermana-angular-navigation-navigation-item.component-DLgcJQOC.mjs} +351 -108
  7. package/fesm2022/{ojiepermana-angular-navigation-navigation-list.component-DfG6_3eF.mjs → ojiepermana-angular-navigation-navigation-list.component-BYc3WCt8.mjs} +23 -3
  8. package/fesm2022/ojiepermana-angular-navigation.mjs +67 -17
  9. package/fesm2022/ojiepermana-angular-theme-component-settings.mjs +152 -109
  10. package/fesm2022/ojiepermana-angular-theme-layout-wrapper.mjs +216 -79
  11. package/fesm2022/ojiepermana-angular-theme-page-root.mjs +4 -0
  12. package/fesm2022/ojiepermana-angular-theme-shell.mjs +4 -0
  13. package/navigation/README.md +92 -3
  14. package/package.json +2 -2
  15. package/theme/component/settings/README.md +19 -0
  16. package/theme/layout/README.md +67 -0
  17. package/theme/styles/css/base/components.css +20 -0
  18. package/theme/styles/css/base/tokens.css +6 -0
  19. package/types/ojiepermana-angular-navigation-types.d.ts +3 -3
  20. package/types/ojiepermana-angular-navigation.d.ts +16 -0
  21. package/types/ojiepermana-angular-theme-component-settings.d.ts +18 -1
  22. package/types/ojiepermana-angular-theme-layout-wrapper.d.ts +125 -14
@@ -60,8 +60,9 @@ Type dipilih lewat komponen anak deklaratif (`NavigationSidebar`, `NavigationDoc
60
60
  - `dockbar-route-context` on `NavigationDockbar` opts into Router-aware header, rail deduplication,
61
61
  and sticky-panel restore behavior. Pass `true` for the default Angular Router adapter or a
62
62
  `NavigationDockbarRouteConfig` to override URL, metadata, or the fallback icon.
63
- - `dockbar-badge` on `NavigationDockbar` accepts a generic badge registry keyed by
64
- `NavigationItem.badge.source` or route `data.navigationBadge`.
63
+ - `badge-context` on `Navigation` supplies one reactive badge registry for every navigation type, keyed by
64
+ `NavigationItem.badge.source` (and route `data.navigationBadge` for the dockbar header).
65
+ `NavigationDockbar` also accepts `badge-context`; its legacy `dockbar-badge` input remains supported.
65
66
  - `ariaLabel` overrides the host navigation label and defaults to `Primary navigation`.
66
67
  - `label` on `NavigationFlyout` sets the single trigger label and defaults to `Menu`.
67
68
  - `icon` on `NavigationFlyout` renders a Lucide icon on the trigger (the name must be registered with `provideIcons()`); `icon-position` (`start`/`end`) sets its placement and `icon-only` hides the label visually while keeping it as the accessible name (compact mode is always icon-only and falls back to the `menu` icon).
@@ -91,6 +92,8 @@ Type dipilih lewat komponen anak deklaratif (`NavigationSidebar`, `NavigationDoc
91
92
 
92
93
  Inputs pada `<Navigation>` (container):
93
94
 
95
+ `[badge-context]` accepts `NavigationBadgeContext | null` and defaults to the type registry or an empty registry.
96
+
94
97
  | API | Type | Notes |
95
98
  | ----------------- | -------------------------------------------------- | ------------------------------------------------------------------------------- |
96
99
  | `id` | `string` | Navigation instance id. `main` is the only id persisted to `localStorage`. |
@@ -137,7 +140,7 @@ Semua type juga menerima `class` untuk kelas tambahan pada elemen shell-nya.
137
140
  | `title`, `subtitle`, `tooltip` | `string` | Primary labels and optional compact tooltip. |
138
141
  | `active`, `disabled` | `boolean` | Explicit active and disabled flags. |
139
142
  | `icon` | `string` | Rendered through the default icon slot unless overridden. |
140
- | `badge` | `{ title?: string; classes?: string; source?: string }` | Static item label plus an optional dockbar badge-source key. |
143
+ | `badge` | `{ title?: string; classes?: string; source?: string }` | Static item label plus an optional shared badge-source key. |
141
144
  | `classes` | `{ wrapper?, container?, icon?, title?, subtitle? }` | Per-item class overrides. `container` targets the horizontal group `<li>` wrapper. |
142
145
  | `meta` | `Record<string, unknown>` | Consumer-owned metadata bag. |
143
146
  | `isHidden` | `(item) => boolean` | Filters items at normalization time. |
@@ -423,3 +426,89 @@ tetap sama; hanya distribusi chunk di sisi consumer yang lebih ringan.
423
426
  Angular 22.2–22.x CSR/browser usage is supported; SSR, prerendering, and hydration are not. See the
424
427
  bundled `SUPPORT.md`. Report suspected vulnerabilities privately using the instructions in the
425
428
  bundled `SECURITY.md`. This package is MIT licensed; see the bundled `LICENSE`.
429
+
430
+ ## Shared reactive badge counts
431
+
432
+ All navigation types use the same `NavigationBadgeContext`. Bind it to `[badge-context]` on
433
+ `Navigation`. Items only carry a source key, so updating a Signal or Observable does not rebuild
434
+ the navigation tree. The registry belongs to the consumer, with no global or per-type registry.
435
+ The library performs no fetching, polling, authentication, sockets, or business counting.
436
+
437
+ ```ts
438
+ import { signal } from '@angular/core';
439
+ import { BehaviorSubject } from 'rxjs';
440
+ import type { NavigationBadgeContext, NavigationItem } from '@ojiepermana/angular/navigation';
441
+
442
+ // Members of the consumer component:
443
+ readonly taskCount = signal(3);
444
+ readonly reviewCount$ = new BehaviorSubject<number | null>(10);
445
+ readonly navigation: readonly NavigationItem[] = [
446
+ { id: 'tasks', title: 'Tugas', icon: 'circle-check-big', link: '/my/tasks', badge: { source: 'tasks' } },
447
+ { id: 'reviews', title: 'Review', icon: 'file', link: '/my/reviews', badge: { source: 'reviews' } },
448
+ { id: 'guide', title: 'Panduan', link: '/guide', badge: { title: 'New' } },
449
+ ];
450
+ readonly badgeContext: NavigationBadgeContext = {
451
+ tasks: { value: this.taskCount, ariaLabel: count => `${count} tugas` },
452
+ reviews: { value: this.reviewCount$, ariaLabel: count => `${count} review` },
453
+ };
454
+
455
+ // Run these in consumer event handlers after updating consumer data:
456
+ // this.taskCount.set(120);
457
+ // this.reviewCount$.next(99);
458
+ ```
459
+
460
+ ```html
461
+ <Navigation id="main" [data]="navigation" [badge-context]="badgeContext">
462
+ <NavigationSidebar />
463
+ </Navigation>
464
+ ```
465
+
466
+ Replace the type child with `NavigationMinidock`, `NavigationDockbar`, `NavigationNavbar`, or
467
+ `NavigationFlyout` without changing the registry. Minidock still requires flat navigation items;
468
+ use `toMinidockItems()` for a tree. Register icon names with `provideIcons()` as usual. Multiple
469
+ `Navigation` instances can bind the same registry and react together.
470
+
471
+ `NavigationBadgeSource.value` accepts `number | null | undefined`, `Signal`, `Observable`, or a
472
+ zero-argument reader returning that count. Reader functions are evaluated during Angular checks;
473
+ reading signals inside them tracks those signals. A plain external variable needs an Angular change
474
+ notification, so prefer Signal or Observable for asynchronous updates.
475
+
476
+ Finite numeric values are truncated toward zero before display and accessible labeling. Zero,
477
+ negative values, null, undefined, NaN, Infinity, and unknown source keys hide the badge. Values
478
+ 1–99 display their number; values above 99 display `99+`. The `ariaLabel` callback receives the
479
+ normalized, uncapped count. A string can supply a complete accessible label; without a label the
480
+ fallback is `<count> items`. Keep the actual count in consumer labels, including when capped.
481
+ Source keys are resolved as own registry properties. When `source` is present it takes precedence
482
+ over `title`, even when that source is missing or hidden. Text-only `badge.title` remains supported.
483
+
484
+ Observable errors hide the badge. Source replacement unsubscribes the previous Observable and
485
+ never renders its cached count for the replacement. Destroying a badge view unsubscribes it.
486
+ Changing a sidebar between labelled, collapsed, hover, and keyboard preview layouts keeps the same
487
+ badge view and subscription, including the last emission from a non-replaying Observable.
488
+ Each visible badge owns its subscription; use `shareReplay({ bufferSize: 1, refCount: true })` in
489
+ the consumer when several views use a cold Observable and should share its work.
490
+
491
+ Labelled items reserve space at the right for a nonshrinking red pill. Count badges use
492
+ `destructive` / `destructive-foreground`, 20px minimum width and height, 10px type, and 4px inline
493
+ padding at normal density. Collapsed sidebar, minidock, and dockbar rails show a smaller 16px badge
494
+ over the icon corner, without changing the item hit area. A sidebar hover or keyboard preview uses
495
+ the labelled version, with one badge per item. Geometry follows the theme space axis through
496
+ `--nav-count-height`, `--nav-count-compact-height`, `--nav-count-padding`, and `--nav-count-offset`;
497
+ font size uses `--nav-count-font-size`. Static text badges retain their existing styling.
498
+
499
+ ### Migration
500
+
501
+ Existing `<NavigationDockbar [dockbar-badge]="registry" />` continues to work, including its
502
+ route-context header and aside. Prefer moving the binding to its parent:
503
+
504
+ ```html
505
+ <Navigation [data]="navigation" [badge-context]="registry">
506
+ <NavigationDockbar [dockbar-route-context]="true" />
507
+ </Navigation>
508
+ ```
509
+
510
+ For a dockbar-only assembly, `[badge-context]` is also accepted on `NavigationDockbar`.
511
+ If both old and new dockbar inputs are bound, its generic input wins. A registry on `Navigation`
512
+ takes precedence over the type-level registry as a whole (including an explicit empty object).
513
+ `LayoutWrapperDefault` also accepts `[badge-context]` for every desktop navigation type and its
514
+ mobile sidebar; `[dockbar-badge]` remains its fallback for compatibility.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ojiepermana/angular",
3
- "version": "22.2.3",
3
+ "version": "22.2.5",
4
4
  "description": "Accessible, tree-shakable Angular 22 design system from ojiepermana: UI components, charts, navigation shells, theme tokens, and an OpenAPI SDK generator.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -503,5 +503,5 @@
503
503
  "module": "fesm2022/ojiepermana-angular.mjs",
504
504
  "typings": "types/ojiepermana-angular.d.ts",
505
505
  "type": "module",
506
- "gitHead": "f5001a56a4c9a8b75b71254febe765be1e9a5b6d"
506
+ "gitHead": "0f9117817faca017f5aab776cf340eb939fee4ba"
507
507
  }
@@ -41,6 +41,25 @@ open; Escape, backdrop click, and the close controls dismiss it; focus returns
41
41
  to the opening trigger. Its header and footer use the navigation topbar height,
42
42
  semantic borders, and theme tokens so it sits naturally beside a layout shell.
43
43
 
44
+ ## Inline page
45
+
46
+ ```html
47
+ <ThemeSettings inline />
48
+ ```
49
+
50
+ `inline` renders the same sections directly in the page: no trigger, no drawer,
51
+ no backdrop, and `open` is ignored. It is the right shape for a dedicated
52
+ settings route, while a navigation footer keeps the drawer. Both modes share the
53
+ runtime services and the same `THEME_SETTINGS_ADAPTER` gate, so an inline page
54
+ and an open drawer always show the same values: a swatch chosen on one is
55
+ checked on the other at once. The container carries `data-theme-settings-inline`
56
+ as a styling hook. The default stays `false`, so existing drawers are untouched.
57
+
58
+ Each instance owns its accent and neutral radio groups (a per-application unique
59
+ `name`), so several instances on one document, inline and drawer together, never
60
+ uncheck each other through native radio grouping. The ids are deterministic per
61
+ application injector, so SSR and hydration agree.
62
+
44
63
  ## Shell
45
64
 
46
65
  Directly below **Theme** sits a **Shell** section with all three shell axes, driven
@@ -358,6 +358,73 @@ cookie, dan target redirect berbeda tiap aplikasi, jadi efeknya milik consumer.
358
358
  Consumer yang tidak mengikat `(logout)` tetap merender tanpa error; tombolnya
359
359
  sekadar tidak melakukan apa pun.
360
360
 
361
+ #### Identitas user di footer: `LayoutUser` dan `provideLayoutUserOptions()`
362
+
363
+ Setiap nav type merender footer user lewat satu komponen bersama, `LayoutUser`:
364
+ sidebar (termasuk Sheet mobile), rail dockbar beserta aside-nya, minidock, navbar,
365
+ dan panel flyout. Default yang lama tidak berubah: surface vertical menampilkan
366
+ inisial, nama, dan email; navbar dan flyout hanya tombol logout; di samping logout
367
+ ada shortcut `ThemeSettings`; ikonnya `log-out`.
368
+
369
+ Konfigurasi aplikasi-wide disediakan sekali lewat token, sehingga tampilannya
370
+ konsisten di semua surface tanpa menyentuh input komponen internal:
371
+
372
+ ```ts
373
+ import { provideLayoutUserOptions } from '@ojiepermana/angular/theme/layout/wrapper';
374
+
375
+ export const appConfig = {
376
+ providers: [
377
+ provideLayoutUserOptions({
378
+ detailed: true, // inisial + nama juga pada navbar dan flyout
379
+ showEmail: false, // sembunyikan baris email
380
+ showThemeSettings: false, // settings sudah tersedia di halaman tersendiri
381
+ logoutIcon: 'door-open', // 'log-out' dan 'door-open' terdaftar di library
382
+ logoutLabel: 'Keluar',
383
+ }),
384
+ ],
385
+ };
386
+ ```
387
+
388
+ | Opsi | Type | Default | Deskripsi |
389
+ | ------------------- | --------- | ----------- | --------------------------------------------------------------- |
390
+ | `detailed` | `boolean` | `false` | Tampilkan identitas pada semua surface, termasuk navbar/flyout. |
391
+ | `showEmail` | `boolean` | `true` | Render `user.email` di bawah nama. |
392
+ | `showThemeSettings` | `boolean` | `true` | Render shortcut `ThemeSettings` di samping logout. |
393
+ | `logoutLabel` | `string` | `'Logout'` | Accessible name tombol logout. |
394
+ | `logoutIcon` | `string` | `'log-out'` | Nama ikon Lucide; nama lain didaftarkan lewat `provideIcons()`. |
395
+
396
+ Input pada `<LayoutUser>` sendiri (`detailed`, `show-initial`, `show-email`,
397
+ `show-theme-settings`, `logoutLabel`, `logoutIcon`) selalu menang atas opsi
398
+ tersebut; nilai yang tidak diikat jatuh ke opsi, lalu ke default di atas.
399
+ `show-initial` ada untuk surface yang sudah menampilkan inisial di tempat lain,
400
+ seperti aside dockbar yang menampilkan inisialnya di rail. Nama panjang
401
+ dipotong (`truncate`) pada kolom judul yang `min-w-0 flex-1`, jadi tombol logout
402
+ tidak pernah terdorong atau terpotong.
403
+
404
+ #### Brand: inisial, ikon, atau wordmark
405
+
406
+ `BrandIdentity` menerima `wordmark` dan `tagline` opsional. Dengan `wordmark`,
407
+ `LayoutBrand` merender teks tersebut (plus tagline bila ada) menggantikan blok
408
+ inisial/ikon; tanpa `wordmark`, fallback `NavigationHeaderInitial` tetap dipakai.
409
+ Accessible name selalu `brand.name` (`role="img"`), dan `title`/`subtitle` tetap
410
+ mengikuti aturan `compact` yang sama.
411
+
412
+ ```ts
413
+ const brand: BrandIdentity = {
414
+ name: 'PT Contoh Nusantara',
415
+ icon: null,
416
+ title: 'Contoh Nusantara',
417
+ subtitle: 'Enterprise Operations',
418
+ wordmark: 'CONTOH',
419
+ tagline: 'NUSANTARA SYSTEM',
420
+ };
421
+ ```
422
+
423
+ Hook styling untuk consumer: `[data-layout-brand-mark]` (dengan `data-compact`
424
+ `"true"`/`"false"`), `[data-layout-brand-wordmark]`, dan
425
+ `[data-layout-brand-tagline]`. Library hanya mengatur tier tipografi dan
426
+ `truncate`; warna, ukuran, dan tata letak milik consumer.
427
+
361
428
  Saat viewport kembali ke desktop, Sheet ditutup otomatis. Pemilihan item mobile juga menutup
362
429
  Sheet dan mengembalikan fokus melalui primitive Sheet.
363
430
 
@@ -172,6 +172,26 @@
172
172
  letter-spacing: 0;
173
173
  }
174
174
 
175
+ .nav-count {
176
+ height: var(--nav-count-height);
177
+ min-width: var(--nav-count-height);
178
+ padding-inline: var(--nav-count-padding);
179
+ font-family: var(--nav-badge-font-family);
180
+ font-size: var(--nav-count-font-size);
181
+ line-height: 1;
182
+ font-weight: 600;
183
+ font-variant-numeric: tabular-nums;
184
+ }
185
+
186
+ .nav-count-overlay {
187
+ position: absolute;
188
+ top: var(--nav-count-offset);
189
+ right: var(--nav-count-offset);
190
+ height: var(--nav-count-compact-height);
191
+ min-width: var(--nav-count-compact-height);
192
+ z-index: 20;
193
+ }
194
+
175
195
  /* Modal overlay backdrop shared by Dialog, Sheet, and Drawer. The element is
176
196
  * rendered inside the CDK overlay container (outside component view
177
197
  * encapsulation), so its styles must live in this global layer. The default
@@ -146,6 +146,12 @@
146
146
  --nav-badge-size: var(--text-2xs-plus);
147
147
  --nav-badge-line-height: var(--text-2xs-plus--line-height);
148
148
  --nav-badge-weight: 500;
149
+ /* Count badges: 20px beside labels, 16px on icon rails at normal density. */
150
+ --nav-count-height: calc(var(--spacing-base) * 5);
151
+ --nav-count-compact-height: calc(var(--spacing-base) * 4);
152
+ --nav-count-padding: var(--spacing-base);
153
+ --nav-count-offset: calc(var(--spacing-base) * -2);
154
+ --nav-count-font-size: calc(var(--font-size-base) * 0.625);
149
155
  /* Item subtitles/descriptions — a quiet 12px tier under labels. */
150
156
  --nav-subtitle-size: calc(var(--font-size-base) * 0.75);
151
157
  --nav-subtitle-line-height: 1.35;
@@ -22,7 +22,7 @@ export type NavigationBadgeAriaLabel = string | ((count: number) => string);
22
22
  /** Sumber badge generik yang dapat direferensikan navigation item atau route metadata. */
23
23
  export interface NavigationBadgeSource {
24
24
  readonly value: NavigationBadgeValueSource;
25
- readonly ariaLabel: NavigationBadgeAriaLabel;
25
+ readonly ariaLabel?: NavigationBadgeAriaLabel;
26
26
  readonly classes?: string;
27
27
  }
28
28
  export type NavigationBadgeContext = Readonly<Record<string, NavigationBadgeSource>>;
@@ -79,7 +79,7 @@ export interface NavigationItemClasses {
79
79
  export interface NavigationItemBadge {
80
80
  readonly title?: string;
81
81
  readonly classes?: string;
82
- /** Key generik yang dicari pada input `dockbar-badge`. */
82
+ /** Key generik yang dicari pada input `badge-context`. */
83
83
  readonly source?: string;
84
84
  }
85
85
  export type NavigationVisibilityHandler = (item: NavigationItem) => boolean;
@@ -136,7 +136,7 @@ export interface NavigationIconContext {
136
136
  readonly level: number;
137
137
  }
138
138
  export declare function normalizeUiNavItems(items: readonly NavigationItem[]): readonly NavigationNormalizedItem[];
139
- /** Format visual count badge dockbar. Count nol atau invalid tidak dirender. */
139
+ /** Format visual count badge navigasi. Count nol atau invalid tidak dirender. */
140
140
  export declare function formatNavigationBadgeCount(value: NavigationBadgeCount): string | null;
141
141
  /**
142
142
  * Memadatkan divider: yang di awal, di akhir, dan yang berurutan dibuang. Dari
@@ -80,6 +80,8 @@ export declare class NavigationContainerComponent implements NavigationShellCont
80
80
  /** Id data publik dapat dipisahkan dari id state. Berguna untuk mirror mobile tanpa berbagi persistence state. */
81
81
  readonly dataId: import("@angular/core").InputSignal<string | null>;
82
82
  readonly data: import("@angular/core").InputSignal<readonly NavigationItem$1[]>;
83
+ /** Registry badge bersama untuk semua jenis navigasi. */
84
+ readonly badgeContext: import("@angular/core").InputSignal<Readonly<Record<string, NavigationBadgeSource$1>> | null>;
83
85
  readonly ariaLabel: import("@angular/core").InputSignal<string>;
84
86
  readonly compact: import("@angular/core").InputSignal<boolean>;
85
87
  readonly collapseTree: import("@angular/core").InputSignal<NavigationCollapseTree$1>;
@@ -116,6 +118,8 @@ export declare class NavigationContainerComponent implements NavigationShellCont
116
118
  private readonly collapsedPreference;
117
119
  private readonly dockbarModePreference;
118
120
  private readonly dockbarRouteContextPreference;
121
+ readonly resolvedBadgeContext: import("@angular/core").Signal<Readonly<Record<string, NavigationBadgeSource$1>>>;
122
+ /** @deprecated Gunakan resolvedBadgeContext. */
119
123
  readonly dockbarBadgeContext: import("@angular/core").Signal<Readonly<Record<string, NavigationBadgeSource$1>>>;
120
124
  readonly dockbarRouteHeaderVisible: import("@angular/core").Signal<boolean>;
121
125
  /** Template footer aside dockbar dari slot `ng-template[NavigationAsideFooter]`. */
@@ -193,6 +197,11 @@ export declare class NavigationContainerComponent implements NavigationShellCont
193
197
  "required": false;
194
198
  "isSignal": true;
195
199
  };
200
+ "badgeContext": {
201
+ "alias": "badge-context";
202
+ "required": false;
203
+ "isSignal": true;
204
+ };
196
205
  "ariaLabel": {
197
206
  "alias": "ariaLabel";
198
207
  "required": false;
@@ -403,6 +412,8 @@ export declare class NavigationDockbarComponent {
403
412
  readonly position: import("@angular/core").InputSignal<NavigationVerticalPosition$1 | null>;
404
413
  readonly routeContext: import("@angular/core").InputSignal<NavigationDockbarRouteContext$1 | null>;
405
414
  readonly badgeContext: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>>>;
415
+ readonly badges: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>> | null>;
416
+ private readonly resolvedBadges;
406
417
  readonly class: import("@angular/core").InputSignal<string>;
407
418
  protected readonly headerSlot: import("@angular/core").Signal<NavigationHeaderComponent | undefined>;
408
419
  protected readonly contentSlot: import("@angular/core").Signal<NavigationContentComponent | undefined>;
@@ -436,6 +447,11 @@ export declare class NavigationDockbarComponent {
436
447
  "required": false;
437
448
  "isSignal": true;
438
449
  };
450
+ "badges": {
451
+ "alias": "badge-context";
452
+ "required": false;
453
+ "isSignal": true;
454
+ };
439
455
  "class": {
440
456
  "alias": "class";
441
457
  "required": false;
@@ -6,7 +6,14 @@ import { NavigationType } from "@ojiepermana/angular/navigation/types";
6
6
  import { ShellMode } from "@ojiepermana/angular/theme/shell/types";
7
7
  /** Native control styling exposed by the settings trigger. */
8
8
  type ThemeSettingsTrigger = 'button' | 'link';
9
- /** A navigation-aligned, right-side inspector for runtime theme and shell settings. */
9
+ /**
10
+ * A navigation-aligned, right-side inspector for runtime theme and shell settings.
11
+ *
12
+ * `inline` renders the same sections directly in the page instead: no trigger,
13
+ * no drawer, no backdrop. Both modes read and write the same services and the
14
+ * same adapter, so an inline page and an open drawer stay in sync without any
15
+ * extra wiring.
16
+ */
10
17
  export declare class ThemeSettingsComponent {
11
18
  /**
12
19
  * Present only when the app provided an adapter. It is a render gate here: the
@@ -15,6 +22,11 @@ export declare class ThemeSettingsComponent {
15
22
  */
16
23
  protected readonly settings: import("@ojiepermana/angular/theme/component/settings").ThemeSettingsAdapter | null;
17
24
  readonly open: import("@angular/core").ModelSignal<boolean>;
25
+ /**
26
+ * Render the sections in place, as page content, instead of behind a trigger
27
+ * and drawer. `open` is ignored while inline: there is no overlay to open.
28
+ */
29
+ readonly inline: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
18
30
  readonly trigger: import("@angular/core").InputSignal<ThemeSettingsTrigger>;
19
31
  readonly triggerLabel: import("@angular/core").InputSignal<string>;
20
32
  readonly triggerIconOnly: import("@angular/core").InputSignal<boolean>;
@@ -29,6 +41,11 @@ export declare class ThemeSettingsComponent {
29
41
  "required": false;
30
42
  "isSignal": true;
31
43
  };
44
+ "inline": {
45
+ "alias": "inline";
46
+ "required": false;
47
+ "isSignal": true;
48
+ };
32
49
  "trigger": {
33
50
  "alias": "trigger";
34
51
  "required": false;
@@ -1,5 +1,5 @@
1
1
  import * as i0 from "@angular/core";
2
- import { ElementRef } from "@angular/core";
2
+ import { ElementRef, InjectionToken, Provider } from "@angular/core";
3
3
  import { ThemeSettingsNavigationMode, ThemeSettingsNavigationType } from "@ojiepermana/angular/theme/component/settings";
4
4
  import { NavigationDockbarRouteContext } from "@ojiepermana/angular/navigation";
5
5
  import { NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationItem, NavigationType } from "@ojiepermana/angular/navigation/types";
@@ -16,6 +16,13 @@ export interface BrandIdentity {
16
16
  readonly title: string;
17
17
  /** Subjudul brand. */
18
18
  readonly subtitle: string;
19
+ /**
20
+ * Optional typographic mark rendered in place of the initials or icon. The
21
+ * accessible name stays `name`; the wordmark itself is decorative text.
22
+ */
23
+ readonly wordmark?: string;
24
+ /** Optional line under the wordmark. Ignored without a `wordmark`. */
25
+ readonly tagline?: string;
19
26
  }
20
27
  export interface UserIdentity {
21
28
  /** Nama lengkap user (inisial + judul footer). */
@@ -41,19 +48,73 @@ export declare class LayoutIdentityService {
41
48
  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
42
49
  }
43
50
  /**
44
- * The brand slot for `<NavigationHeader>`: initials or logo plus a title. Purely
45
- * input-driven.
51
+ * Application-wide defaults for every `<LayoutUser>` a layout wrapper renders:
52
+ * the sidebar and its mobile sheet, the dockbar rail and aside, the minidock
53
+ * rail, the navbar and the flyout panel. One provider therefore keeps the
54
+ * identity row and the logout control identical on every surface. A binding on
55
+ * an individual `<LayoutUser>` still wins over these defaults.
56
+ */
57
+ export interface LayoutUserOptions {
58
+ /**
59
+ * Show the initials and name on every surface, the horizontal navbar and
60
+ * flyout footers included. Off, those two render the logout control only.
61
+ */
62
+ readonly detailed?: boolean;
63
+ /** Render `user.email` under the name. Default `true`. */
64
+ readonly showEmail?: boolean;
65
+ /**
66
+ * Render the `ThemeSettings` shortcut beside logout. Default `true`; turn it
67
+ * off when the application offers the settings on a page of its own.
68
+ */
69
+ readonly showThemeSettings?: boolean;
70
+ /** Accessible name of the logout control. Default `'Logout'`. */
71
+ readonly logoutLabel?: string;
72
+ /**
73
+ * Lucide icon name of the logout control. `'log-out'` (the default) and
74
+ * `'door-open'` are registered by the library; register any other name with
75
+ * `provideIcons()`.
76
+ */
77
+ readonly logoutIcon?: string;
78
+ }
79
+ export declare const LAYOUT_USER_OPTIONS: InjectionToken<LayoutUserOptions>;
80
+ /**
81
+ * Provide {@link LayoutUserOptions} once, usually in the application config,
82
+ * so `<LayoutWrapperDefault>` and the standalone nav types all pick them up.
83
+ *
84
+ * ```ts
85
+ * provideLayoutUserOptions({ detailed: true, showEmail: false, logoutIcon: 'door-open' })
86
+ * ```
87
+ */
88
+ export declare function provideLayoutUserOptions(options: LayoutUserOptions): Provider[];
89
+ /**
90
+ * The brand slot for `<NavigationHeader>`: initials, logo, or wordmark plus a title.
91
+ * Purely input-driven.
46
92
  *
47
93
  * `compact` (dockbar, or an icon-only rail) hides the title. `host.class = 'contents'`
48
94
  * keeps `NavigationHeaderInitial` and `NavigationHeaderTitle` as direct flex children of
49
95
  * the header row; the title still auto-hides on a collapsed sidebar, because
50
96
  * `NAVIGATION_SHELL` reaches `<Navigation>` through the live injector tree.
97
+ *
98
+ * A `brand.wordmark` replaces the initials block with typographic text and an
99
+ * optional `brand.tagline`. The mark keeps `role="img"` and `brand.name` as its
100
+ * accessible name, so assistive technology announces the brand the same way in
101
+ * both renders. `data-layout-brand-mark`, `data-layout-brand-wordmark`,
102
+ * `data-layout-brand-tagline` and `data-compact` are the styling hooks: the
103
+ * library sets type and overflow only, the consumer owns the look.
51
104
  */
52
105
  export declare class LayoutBrand {
53
- /** Identitas brand (nama, ikon, judul, subjudul). */
106
+ /** Identitas brand (nama, ikon, judul, subjudul, wordmark opsional). */
54
107
  readonly brand: import("@angular/core").InputSignal<BrandIdentity>;
55
108
  /** Sembunyikan judul, sisakan inisial saja (dockbar / rail ikon-only). */
56
109
  readonly compact: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
110
+ /**
111
+ * Rail-sized type when compact, the nav text tier otherwise. A collapsed sidebar
112
+ * is a rail too, but `LayoutBrand` only knows `compact`; the header it sits in
113
+ * carries `data-collapsed`, so the `in-data-[collapsed=true]` variant shrinks
114
+ * the type there without the component reaching into the navigation state.
115
+ */
116
+ protected readonly wordmarkClasses: import("@angular/core").Signal<string>;
117
+ protected readonly taglineClasses: import("@angular/core").Signal<string>;
57
118
  static ɵfac: i0.ɵɵFactoryDeclaration<LayoutBrand, never>;
58
119
  static ɵcmp: i0.ɵɵComponentDeclaration<LayoutBrand, "LayoutBrand", never, {
59
120
  "brand": {
@@ -70,12 +131,14 @@ export declare class LayoutBrand {
70
131
  }
71
132
  /**
72
133
  * The user slot for `<NavigationFooter>`: an optional identity plus the logout action.
73
- * Purely input-driven.
134
+ * Input-driven, with application defaults from {@link LAYOUT_USER_OPTIONS}.
74
135
  *
75
136
  * `detailed` shows initials and name (a full sidebar); without it, only the logout
76
137
  * button. `host.class = 'contents'` makes the children direct flex children of the
77
138
  * footer, so `ml-auto` and the auto-hide on collapse (through `NAVIGATION_SHELL`) still
78
- * apply.
139
+ * apply. The title takes the remaining width, capped so a horizontal bar does not
140
+ * grow with the name, and truncates, so a long name never pushes the actions out
141
+ * of the row.
79
142
  *
80
143
  * The logout button only emits `(logout)`. Endpoint, cookie, and redirect target differ
81
144
  * per application, so the effect is entirely the consumer's — the library calls no
@@ -84,16 +147,34 @@ export declare class LayoutBrand {
84
147
  * existed.
85
148
  */
86
149
  export declare class LayoutUser {
150
+ private readonly options;
87
151
  /** Identitas user (nama + email). */
88
152
  readonly user: import("@angular/core").InputSignal<UserIdentity>;
89
153
  /** Show the user identity (initials and name), not only the logout button. */
90
154
  readonly detailed: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
91
- /** Accessible name for the logout button. */
92
- readonly logoutLabel: import("@angular/core").InputSignal<string>;
93
- /** Lucide icon name for the logout button; register a custom one with `provideIcons()`. */
94
- readonly logoutIcon: import("@angular/core").InputSignal<string>;
155
+ /**
156
+ * Render the initials block in front of the name. Off where another block already
157
+ * shows them, such as the dockbar aside whose rail carries the initials.
158
+ */
159
+ readonly showInitial: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
160
+ /** Render the email under the name; unset falls back to the options, then `true`. */
161
+ readonly showEmail: import("@angular/core").InputSignalWithTransform<boolean | null, unknown>;
162
+ /** Render the ThemeSettings shortcut; unset falls back to the options, then `true`. */
163
+ readonly showThemeSettings: import("@angular/core").InputSignalWithTransform<boolean | null, unknown>;
164
+ /** Accessible name for the logout button; unset falls back to the options, then `Logout`. */
165
+ readonly logoutLabel: import("@angular/core").InputSignal<string | null>;
166
+ /**
167
+ * Lucide icon name for the logout button; unset falls back to the options, then
168
+ * `log-out`. `door-open` is registered too; register any other name with `provideIcons()`.
169
+ */
170
+ readonly logoutIcon: import("@angular/core").InputSignal<string | null>;
95
171
  /** The user pressed logout. The effect is the consumer's; the library does not navigate. */
96
172
  readonly logout: import("@angular/core").OutputEmitterRef<void>;
173
+ protected readonly showsIdentity: import("@angular/core").Signal<boolean>;
174
+ protected readonly showsEmail: import("@angular/core").Signal<boolean>;
175
+ protected readonly showsThemeSettings: import("@angular/core").Signal<boolean>;
176
+ protected readonly resolvedLogoutLabel: import("@angular/core").Signal<string>;
177
+ protected readonly resolvedLogoutIcon: import("@angular/core").Signal<string>;
97
178
  static ɵfac: i0.ɵɵFactoryDeclaration<LayoutUser, never>;
98
179
  static ɵcmp: i0.ɵɵComponentDeclaration<LayoutUser, "LayoutUser", never, {
99
180
  "user": {
@@ -106,6 +187,21 @@ export declare class LayoutUser {
106
187
  "required": false;
107
188
  "isSignal": true;
108
189
  };
190
+ "showInitial": {
191
+ "alias": "show-initial";
192
+ "required": false;
193
+ "isSignal": true;
194
+ };
195
+ "showEmail": {
196
+ "alias": "show-email";
197
+ "required": false;
198
+ "isSignal": true;
199
+ };
200
+ "showThemeSettings": {
201
+ "alias": "show-theme-settings";
202
+ "required": false;
203
+ "isSignal": true;
204
+ };
109
205
  "logoutLabel": {
110
206
  "alias": "logoutLabel";
111
207
  "required": false;
@@ -179,7 +275,8 @@ export declare class LayoutNavSidebar {
179
275
  * header, the user's initials in the rail footer (title and actions auto-hide, because
180
276
  * the rail is always collapsed), and the full identity (name, email, logout) in the
181
277
  * aside footer — together with the rail initials they form one footer row, like an
182
- * expanded sidebar.
278
+ * expanded sidebar. Both rows are the one `LayoutUser`; the aside copy only drops the
279
+ * initials the rail already shows.
183
280
  *
184
281
  * Horizontal dividers: unlike the sidebar, which leaves the separator to Layout's inset
185
282
  * accent rail at `top-12`/`bottom-12` under `border-rail`, the dockbar ALWAYS uses the
@@ -196,7 +293,8 @@ export declare class LayoutNavDockbar {
196
293
  readonly navTypeMode: import("@angular/core").InputSignal<ThemeSettingsNavigationMode>;
197
294
  /** Opt-in route-aware header; ketika aktif, header route menggantikan compact brand. */
198
295
  readonly dockbarRouteContext: import("@angular/core").InputSignal<NavigationDockbarRouteContext | null>;
199
- /** The generic badge registry forwarded to `NavigationDockbar`. */
296
+ readonly badgeContext: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>> | null>;
297
+ /** @deprecated Gunakan badge-context. The generic badge registry forwarded to `NavigationDockbar`. */
200
298
  readonly dockbarBadgeContext: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>>>;
201
299
  /** Forwarded from the rail and aside footer logout buttons; the effect is the consumer's. */
202
300
  readonly logout: import("@angular/core").OutputEmitterRef<void>;
@@ -232,6 +330,11 @@ export declare class LayoutNavDockbar {
232
330
  "required": false;
233
331
  "isSignal": true;
234
332
  };
333
+ "badgeContext": {
334
+ "alias": "badge-context";
335
+ "required": false;
336
+ "isSignal": true;
337
+ };
235
338
  "dockbarBadgeContext": {
236
339
  "alias": "dockbar-badge";
237
340
  "required": false;
@@ -405,7 +508,10 @@ export declare class LayoutWrapperDefault {
405
508
  readonly navTypeMode: import("@angular/core").InputSignal<ThemeSettingsNavigationMode>;
406
509
  /** Opt-in route-aware dockbar state; ignored by other navigation types. */
407
510
  readonly dockbarRouteContext: import("@angular/core").InputSignal<NavigationDockbarRouteContext$1 | null>;
408
- /** Generic dockbar badge registry; ignored by sidebar/navbar/flyout. */
511
+ /** Registry badge untuk semua jenis navigasi desktop dan sidebar mobile. */
512
+ readonly badgeContext: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>> | null>;
513
+ protected readonly resolvedBadgeContext: import("@angular/core").Signal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>>>;
514
+ /** @deprecated Gunakan badge-context. */
409
515
  readonly dockbarBadgeContext: import("@angular/core").InputSignal<Readonly<Record<string, import("@ojiepermana/angular/navigation").NavigationBadgeSource>>>;
410
516
  /** Item navigasi. */
411
517
  readonly data: import("@angular/core").InputSignal<readonly NavigationItem[]>;
@@ -449,7 +555,7 @@ export declare class LayoutWrapperDefault {
449
555
  /** Minidock only accepts flat data, so grouped data is flattened before it reaches the rail. */
450
556
  private readonly minidockData;
451
557
  /** Data id of the desktop `<Navigation>`; its state id stays `main` for persistence. */
452
- protected readonly desktopDataId: import("@angular/core").Signal<"main" | "main-minidock">;
558
+ protected readonly desktopDataId: import("@angular/core").Signal<"main-minidock" | "main">;
453
559
  /** Data of the desktop `<Navigation>`: flattened for minidock, unfiltered for every other type. */
454
560
  protected readonly desktopData: import("@angular/core").Signal<readonly NavigationItem[]>;
455
561
  /** Lebar host `<Navigation>`: penuh-tinggi (vertical) atau penuh-lebar (horizontal). */
@@ -496,6 +602,11 @@ export declare class LayoutWrapperDefault {
496
602
  "required": false;
497
603
  "isSignal": true;
498
604
  };
605
+ "badgeContext": {
606
+ "alias": "badge-context";
607
+ "required": false;
608
+ "isSignal": true;
609
+ };
499
610
  "dockbarBadgeContext": {
500
611
  "alias": "dockbar-badge";
501
612
  "required": false;