@ojiepermana/angular 22.2.10 → 22.2.12

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 (110) hide show
  1. package/component/icon/README.md +17 -0
  2. package/fesm2022/ojiepermana-angular-chart-area.mjs +3 -3
  3. package/fesm2022/ojiepermana-angular-chart-bar.mjs +3 -3
  4. package/fesm2022/ojiepermana-angular-chart-core.mjs +34 -34
  5. package/fesm2022/ojiepermana-angular-chart-line.mjs +3 -3
  6. package/fesm2022/ojiepermana-angular-chart-pie.mjs +3 -3
  7. package/fesm2022/ojiepermana-angular-chart-primitives.mjs +33 -33
  8. package/fesm2022/ojiepermana-angular-chart-radar.mjs +3 -3
  9. package/fesm2022/ojiepermana-angular-chart-radial.mjs +3 -3
  10. package/fesm2022/ojiepermana-angular-chart-scatter.mjs +3 -3
  11. package/fesm2022/ojiepermana-angular-component-accordion.mjs +15 -15
  12. package/fesm2022/ojiepermana-angular-component-alert-dialog.mjs +27 -27
  13. package/fesm2022/ojiepermana-angular-component-alert.mjs +12 -12
  14. package/fesm2022/ojiepermana-angular-component-aspect-ratio.mjs +3 -3
  15. package/fesm2022/ojiepermana-angular-component-avatar.mjs +18 -18
  16. package/fesm2022/ojiepermana-angular-component-badge.mjs +3 -3
  17. package/fesm2022/ojiepermana-angular-component-breadcrumb.mjs +21 -21
  18. package/fesm2022/ojiepermana-angular-component-button-group.mjs +9 -9
  19. package/fesm2022/ojiepermana-angular-component-button.mjs +3 -3
  20. package/fesm2022/ojiepermana-angular-component-calendar.mjs +3 -3
  21. package/fesm2022/ojiepermana-angular-component-card.mjs +21 -21
  22. package/fesm2022/ojiepermana-angular-component-carousel.mjs +18 -18
  23. package/fesm2022/ojiepermana-angular-component-checkbox.mjs +3 -3
  24. package/fesm2022/ojiepermana-angular-component-collapsible.mjs +12 -12
  25. package/fesm2022/ojiepermana-angular-component-combobox.mjs +3 -3
  26. package/fesm2022/ojiepermana-angular-component-command.mjs +27 -27
  27. package/fesm2022/ojiepermana-angular-component-composer.mjs +21 -21
  28. package/fesm2022/ojiepermana-angular-component-context-menu.mjs +3 -3
  29. package/fesm2022/ojiepermana-angular-component-date-picker.mjs +3 -3
  30. package/fesm2022/ojiepermana-angular-component-dialog.mjs +21 -21
  31. package/fesm2022/ojiepermana-angular-component-dropdown-menu.mjs +39 -39
  32. package/fesm2022/ojiepermana-angular-component-editor.mjs +18 -18
  33. package/fesm2022/ojiepermana-angular-component-empty.mjs +18 -18
  34. package/fesm2022/ojiepermana-angular-component-form.mjs +36 -36
  35. package/fesm2022/ojiepermana-angular-component-hover-card.mjs +9 -9
  36. package/fesm2022/ojiepermana-angular-component-icon.mjs +6 -6
  37. package/fesm2022/ojiepermana-angular-component-input-group.mjs +18 -18
  38. package/fesm2022/ojiepermana-angular-component-input-otp.mjs +15 -15
  39. package/fesm2022/ojiepermana-angular-component-input.mjs +3 -3
  40. package/fesm2022/ojiepermana-angular-component-item.mjs +30 -30
  41. package/fesm2022/ojiepermana-angular-component-kanban.mjs +27 -27
  42. package/fesm2022/ojiepermana-angular-component-kbd.mjs +6 -6
  43. package/fesm2022/ojiepermana-angular-component-label.mjs +3 -3
  44. package/fesm2022/ojiepermana-angular-component-menubar.mjs +12 -12
  45. package/fesm2022/ojiepermana-angular-component-native-select.mjs +9 -9
  46. package/fesm2022/ojiepermana-angular-component-navigation-menu.mjs +21 -21
  47. package/fesm2022/ojiepermana-angular-component-pagination.mjs +3 -3
  48. package/fesm2022/ojiepermana-angular-component-pillbox.mjs +15 -15
  49. package/fesm2022/ojiepermana-angular-component-popover.mjs +6 -6
  50. package/fesm2022/ojiepermana-angular-component-progress.mjs +3 -3
  51. package/fesm2022/ojiepermana-angular-component-radio.mjs +6 -6
  52. package/fesm2022/ojiepermana-angular-component-resizable.mjs +12 -12
  53. package/fesm2022/ojiepermana-angular-component-scroll-area.mjs +3 -3
  54. package/fesm2022/ojiepermana-angular-component-segmented-control.mjs +9 -7
  55. package/fesm2022/ojiepermana-angular-component-select.mjs +6 -6
  56. package/fesm2022/ojiepermana-angular-component-separator.mjs +3 -3
  57. package/fesm2022/ojiepermana-angular-component-sheet.mjs +32 -24
  58. package/fesm2022/ojiepermana-angular-component-skeleton.mjs +3 -3
  59. package/fesm2022/ojiepermana-angular-component-slider.mjs +6 -6
  60. package/fesm2022/ojiepermana-angular-component-spinner.mjs +3 -3
  61. package/fesm2022/ojiepermana-angular-component-switch.mjs +3 -3
  62. package/fesm2022/ojiepermana-angular-component-table.mjs +24 -24
  63. package/fesm2022/ojiepermana-angular-component-tabs.mjs +18 -18
  64. package/fesm2022/ojiepermana-angular-component-textarea.mjs +3 -3
  65. package/fesm2022/ojiepermana-angular-component-timeline.mjs +18 -18
  66. package/fesm2022/ojiepermana-angular-component-toast.mjs +3 -3
  67. package/fesm2022/ojiepermana-angular-component-toggle-group.mjs +9 -9
  68. package/fesm2022/ojiepermana-angular-component-toggle.mjs +3 -3
  69. package/fesm2022/ojiepermana-angular-component-tooltip.mjs +15 -15
  70. package/fesm2022/ojiepermana-angular-component-utils-core.mjs +420 -4
  71. package/fesm2022/ojiepermana-angular-component-utils-scale.mjs +3 -3
  72. package/fesm2022/ojiepermana-angular-navigation-icon.mjs +3 -3
  73. package/fesm2022/{ojiepermana-angular-navigation-navigation-badge-count.component-BxWVj145.mjs → ojiepermana-angular-navigation-navigation-badge-count.component-Bx89vXtg.mjs} +3 -3
  74. package/fesm2022/{ojiepermana-angular-navigation-navigation-dockbar-menu.component-DTPbCqmL.mjs → ojiepermana-angular-navigation-navigation-dockbar-menu.component-DwOSHmKC.mjs} +41 -10
  75. package/fesm2022/{ojiepermana-angular-navigation-navigation-entry-grid.component-Bw532lfJ.mjs → ojiepermana-angular-navigation-navigation-entry-grid.component-DtRHbiBM.mjs} +71 -24
  76. package/fesm2022/{ojiepermana-angular-navigation-navigation-flyout-menu.component-vLVcVQDd.mjs → ojiepermana-angular-navigation-navigation-flyout-menu.component-Bo2nIOJk.mjs} +28 -10
  77. package/fesm2022/{ojiepermana-angular-navigation-navigation-horizontal.component-A1zBBMDS.mjs → ojiepermana-angular-navigation-navigation-horizontal.component-DUyMjBKb.mjs} +10 -8
  78. package/fesm2022/{ojiepermana-angular-navigation-navigation-item.component-C-nz2md7.mjs → ojiepermana-angular-navigation-navigation-item.component-BKmO7Pqa.mjs} +188 -56
  79. package/fesm2022/{ojiepermana-angular-navigation-navigation-list.component-CjcoYtil.mjs → ojiepermana-angular-navigation-navigation-list.component-DI-En6rE.mjs} +24 -4
  80. package/fesm2022/ojiepermana-angular-navigation-service.mjs +7 -7
  81. package/fesm2022/ojiepermana-angular-navigation.mjs +119 -71
  82. package/fesm2022/ojiepermana-angular-theme-component-settings.mjs +329 -69
  83. package/fesm2022/ojiepermana-angular-theme-layout-services.mjs +7 -7
  84. package/fesm2022/ojiepermana-angular-theme-layout-wrapper.mjs +83 -35
  85. package/fesm2022/ojiepermana-angular-theme-layout.mjs +25 -25
  86. package/fesm2022/ojiepermana-angular-theme-on-fill.mjs +3 -3
  87. package/fesm2022/ojiepermana-angular-theme-page-core.mjs +3 -3
  88. package/fesm2022/ojiepermana-angular-theme-page-filter.mjs +6 -6
  89. package/fesm2022/ojiepermana-angular-theme-page-overview.mjs +3 -3
  90. package/fesm2022/ojiepermana-angular-theme-page-root.mjs +15 -6
  91. package/fesm2022/ojiepermana-angular-theme-page-side.mjs +6 -6
  92. package/fesm2022/ojiepermana-angular-theme-page-slots.mjs +12 -12
  93. package/fesm2022/ojiepermana-angular-theme-shell-services.mjs +4 -4
  94. package/fesm2022/ojiepermana-angular-theme-shell.mjs +21 -12
  95. package/fesm2022/ojiepermana-angular-theme-styles.mjs +109 -178
  96. package/navigation/README.md +32 -2
  97. package/package.json +3 -2
  98. package/theme/README.md +5 -0
  99. package/theme/component/settings/README.md +15 -0
  100. package/theme/styles/README.md +71 -1
  101. package/theme/styles/css/base/components.css +29 -75
  102. package/theme/styles/css/base/theme.css +3 -3
  103. package/theme/styles/css/base/tokens.css +8 -0
  104. package/types/ojiepermana-angular-component-segmented-control.d.ts +3 -3
  105. package/types/ojiepermana-angular-component-utils-core.d.ts +147 -3
  106. package/types/ojiepermana-angular-navigation-types.d.ts +2 -0
  107. package/types/ojiepermana-angular-navigation.d.ts +8 -1
  108. package/types/ojiepermana-angular-theme-component-settings.d.ts +11 -3
  109. package/types/ojiepermana-angular-theme-layout-wrapper.d.ts +8 -1
  110. package/types/ojiepermana-angular-theme-styles.d.ts +30 -26
@@ -6,6 +6,8 @@ export type NavigationVerticalType = 'sidebar' | 'dockbar' | 'minidock';
6
6
  export type NavigationHorizontalType = 'navbar' | 'flyout';
7
7
  export type NavigationType = NavigationVerticalType | NavigationHorizontalType;
8
8
  export type NavigationCollapseTree = 'stairs' | 'straight';
9
+ /** Jangkauan konektor parent ke child, tanpa mengubah bentuk collapse tree. */
10
+ export type NavigationRail = 'default' | 'rail-active';
9
11
  export type NavigationAppearance = 'flat' | 'border-rail';
10
12
  export type NavigationVerticalPosition = 'left' | 'right';
11
13
  export type NavigationHorizontalPosition = 'top' | 'bottom';
@@ -1,7 +1,7 @@
1
1
  import { NavigationIconDirective, NavigationIconDirective as NavigationIconDirective$1 } from "@ojiepermana/angular/navigation/icon";
2
2
  import * as i0 from "@angular/core";
3
3
  import { Signal, TemplateRef } from "@angular/core";
4
- import { NAVIGATION_DOCKBAR_FALLBACK_ICON, NavigationActionHandler, NavigationAppearance, NavigationAppearance as NavigationAppearance$1, NavigationBadgeAriaLabel, NavigationBadgeContext, NavigationBadgeContext as NavigationBadgeContext$1, NavigationBadgeCount, NavigationBadgeSource, NavigationBadgeSource as NavigationBadgeSource$1, NavigationBadgeValueSource, NavigationCollapseTree, NavigationCollapseTree as NavigationCollapseTree$1, NavigationDockbarMode, NavigationDockbarMode as NavigationDockbarMode$1, NavigationDockbarRouteConfig, NavigationDockbarRouteContext, NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationFlyoutIconPosition, NavigationFlyoutIconPosition as NavigationFlyoutIconPosition$1, NavigationFlyoutTriggerVariant, NavigationFlyoutTriggerVariant as NavigationFlyoutTriggerVariant$1, NavigationHorizontalPosition, NavigationHorizontalPosition as NavigationHorizontalPosition$1, NavigationHorizontalType, NavigationIconContext, NavigationIconContext as NavigationIconContext$1, NavigationItem, NavigationItem as NavigationItem$1, NavigationItemBadge, NavigationItemClasses, NavigationItemType, NavigationLink, NavigationNormalizedItem, NavigationNormalizedItem as NavigationNormalizedItem$1, NavigationNormalizedItemType, NavigationOrientation, NavigationOrientation as NavigationOrientation$1, NavigationPosition, NavigationPosition as NavigationPosition$1, NavigationRegisterInput, NavigationResolvedRouteContext, NavigationResolvedRouteContext as NavigationResolvedRouteContext$1, NavigationRouteData, NavigationSelection, NavigationSelection as NavigationSelection$1, NavigationState, NavigationState as NavigationState$1, NavigationType, NavigationType as NavigationType$1, NavigationVerticalPosition, NavigationVerticalPosition as NavigationVerticalPosition$1, NavigationVerticalType, NavigationVisibilityHandler, formatNavigationBadgeCount, normalizeUiNavItems, toMinidockItems } from "@ojiepermana/angular/navigation/types";
4
+ import { NAVIGATION_DOCKBAR_FALLBACK_ICON, NavigationActionHandler, NavigationAppearance, NavigationAppearance as NavigationAppearance$1, NavigationBadgeAriaLabel, NavigationBadgeContext, NavigationBadgeContext as NavigationBadgeContext$1, NavigationBadgeCount, NavigationBadgeSource, NavigationBadgeSource as NavigationBadgeSource$1, NavigationBadgeValueSource, NavigationCollapseTree, NavigationCollapseTree as NavigationCollapseTree$1, NavigationDockbarMode, NavigationDockbarMode as NavigationDockbarMode$1, NavigationDockbarRouteConfig, NavigationDockbarRouteContext, NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationFlyoutIconPosition, NavigationFlyoutIconPosition as NavigationFlyoutIconPosition$1, NavigationFlyoutTriggerVariant, NavigationFlyoutTriggerVariant as NavigationFlyoutTriggerVariant$1, NavigationHorizontalPosition, NavigationHorizontalPosition as NavigationHorizontalPosition$1, NavigationHorizontalType, NavigationIconContext, NavigationIconContext as NavigationIconContext$1, NavigationItem, NavigationItem as NavigationItem$1, NavigationItemBadge, NavigationItemClasses, NavigationItemType, NavigationLink, NavigationNormalizedItem, NavigationNormalizedItem as NavigationNormalizedItem$1, NavigationNormalizedItemType, NavigationOrientation, NavigationOrientation as NavigationOrientation$1, NavigationPosition, NavigationPosition as NavigationPosition$1, NavigationRail, NavigationRegisterInput, NavigationResolvedRouteContext, NavigationResolvedRouteContext as NavigationResolvedRouteContext$1, NavigationRouteData, NavigationSelection, NavigationSelection as NavigationSelection$1, NavigationState, NavigationState as NavigationState$1, NavigationType, NavigationType as NavigationType$1, NavigationVerticalPosition, NavigationVerticalPosition as NavigationVerticalPosition$1, NavigationVerticalType, NavigationVisibilityHandler, formatNavigationBadgeCount, normalizeUiNavItems, toMinidockItems } from "@ojiepermana/angular/navigation/types";
5
5
  export * from "@ojiepermana/angular/navigation/core";
6
6
  /**
7
7
  * Konfigurasi yang didaftarkan komponen type (`<NavigationSidebar>`,
@@ -85,6 +85,7 @@ export declare class NavigationContainerComponent implements NavigationShellCont
85
85
  readonly ariaLabel: import("@angular/core").InputSignal<string>;
86
86
  readonly compact: import("@angular/core").InputSignal<boolean>;
87
87
  readonly collapseTree: import("@angular/core").InputSignal<NavigationCollapseTree$1>;
88
+ readonly rail: import("@angular/core").InputSignal<NavigationRail>;
88
89
  readonly class: import("@angular/core").InputSignal<string>;
89
90
  readonly itemClass: import("@angular/core").InputSignal<string>;
90
91
  /** Kelas Tailwind untuk container `<li>` group horizontal (flyout tab / navbar group). */
@@ -217,6 +218,11 @@ export declare class NavigationContainerComponent implements NavigationShellCont
217
218
  "required": false;
218
219
  "isSignal": true;
219
220
  };
221
+ "rail": {
222
+ "alias": "rail";
223
+ "required": false;
224
+ "isSignal": true;
225
+ };
220
226
  "class": {
221
227
  "alias": "class";
222
228
  "required": false;
@@ -419,6 +425,7 @@ export declare class NavigationDockbarComponent {
419
425
  protected readonly contentSlot: import("@angular/core").Signal<NavigationContentComponent | undefined>;
420
426
  protected readonly footerSlot: import("@angular/core").Signal<NavigationFooterComponent | undefined>;
421
427
  protected readonly asideFooterSlot: import("@angular/core").Signal<NavigationAsideFooterDirective | undefined>;
428
+ protected readonly routeIndicatorClasses: import("@angular/core").Signal<string>;
422
429
  protected readonly headerDescendantSources: import("@angular/core").Signal<readonly import("@ojiepermana/angular/navigation").NavigationBadgeSource[]>;
423
430
  private readonly routeContextEnabled;
424
431
  protected readonly hostClasses: import("@angular/core").Signal<string>;
@@ -2,7 +2,7 @@ import { DrawerSide } from "@ojiepermana/angular/component/drawer";
2
2
  import * as i0 from "@angular/core";
3
3
  import { EnvironmentProviders, InjectionToken, Provider, Signal } from "@angular/core";
4
4
  import { LayoutAppearance, LayoutSurface, LayoutType, LayoutWidth } from "@ojiepermana/angular/theme/layout/types";
5
- import { NavigationType } from "@ojiepermana/angular/navigation/types";
5
+ import { NavigationRail, 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';
@@ -107,12 +107,15 @@ interface ThemeSettingsAdapter {
107
107
  readonly width: Signal<LayoutWidth>;
108
108
  readonly navType: Signal<ThemeSettingsNavigationType>;
109
109
  readonly navTypeMode: Signal<ThemeSettingsNavigationMode>;
110
+ /** Optional for compatibility with adapters that predate rail preferences. */
111
+ readonly navRail?: Signal<NavigationRail>;
110
112
  setAppearance(value: LayoutAppearance): void;
111
113
  setSurface(value: LayoutSurface): void;
112
114
  setLayoutType(value: LayoutType): void;
113
115
  setWidth(value: LayoutWidth): void;
114
116
  setNavType(value: ThemeSettingsNavigationType): void;
115
117
  setNavTypeMode(value: ThemeSettingsNavigationMode): void;
118
+ setNavRail?(value: NavigationRail): void;
116
119
  }
117
120
  /** Provide this from an application's persisted layout-settings facade. */
118
121
  export declare const THEME_SETTINGS_ADAPTER: InjectionToken<ThemeSettingsAdapter>;
@@ -120,6 +123,8 @@ export declare const THEME_SETTINGS_ADAPTER: InjectionToken<ThemeSettingsAdapter
120
123
  export declare const NAV_TYPE_STORAGE_KEY = "nav-type";
121
124
  /** Storage key for the persisted navigation presentation mode. Owned by the package. */
122
125
  export declare const NAV_TYPE_MODE_STORAGE_KEY = "nav-type-mode";
126
+ /** Storage key for the parent to child connector extent. */
127
+ export declare const NAV_RAIL_STORAGE_KEY = "nav-rail";
123
128
  /**
124
129
  * Nav types valid for a layout/shell pair — mirrors `LayoutWrapperDefault`
125
130
  * (`navbar`/`flyout` → web horizontal, `sidebar`/`dockbar`/`minidock` → vertical).
@@ -159,17 +164,19 @@ export declare class ThemeSettingsDefaultAdapter implements ThemeSettingsAdapter
159
164
  private readonly storage;
160
165
  private readonly layout;
161
166
  private readonly shell;
162
- readonly surface: import("@angular/core").Signal<"flat" | "grid" | "grid-line" | "honeycomb" | "matrix" | "circuit" | "line-vertical" | "line-horizontal">;
167
+ readonly surface: import("@angular/core").Signal<"grid" | "flat" | "grid-line" | "honeycomb" | "matrix" | "circuit" | "line-vertical" | "line-horizontal">;
163
168
  readonly appearance: import("@angular/core").Signal<"flat" | "border-rail">;
164
169
  readonly width: import("@angular/core").Signal<"fluid" | "full" | "wide" | "container">;
165
170
  private readonly layoutTypeState;
166
171
  private readonly navTypeState;
167
172
  private readonly navTypeModeState;
173
+ private readonly navRailState;
174
+ readonly navRail: import("@angular/core").Signal<NavigationRail>;
168
175
  readonly layoutType: import("@angular/core").Signal<"vertical" | "horizontal" | "empty" | "fluid">;
169
176
  readonly navType: import("@angular/core").Signal<ThemeSettingsNavigationType>;
170
177
  readonly navTypeMode: import("@angular/core").Signal<ThemeSettingsNavigationMode>;
171
178
  /** Shell mode the nav-type constraints are resolved against. */
172
- readonly shellMode: import("@angular/core").Signal<"desktop" | "web" | "tablet" | "mobile">;
179
+ readonly shellMode: import("@angular/core").Signal<"tablet" | "desktop" | "web" | "mobile">;
173
180
  constructor();
174
181
  setSurface(surface: LayoutSurface): void;
175
182
  setAppearance(appearance: LayoutAppearance): void;
@@ -177,6 +184,7 @@ export declare class ThemeSettingsDefaultAdapter implements ThemeSettingsAdapter
177
184
  setLayoutType(type: LayoutType): void;
178
185
  setNavType(type: ThemeSettingsNavigationType): void;
179
186
  setNavTypeMode(mode: ThemeSettingsNavigationMode): void;
187
+ setNavRail(rail: NavigationRail): void;
180
188
  /**
181
189
  * Auto-correct the lower-priority axes a layout type invalidates, so the
182
190
  * rendered shell never lands in an inconsistent state (e.g. `vertical` +
@@ -2,7 +2,7 @@ import * as i0 from "@angular/core";
2
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
- import { NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationItem, NavigationType } from "@ojiepermana/angular/navigation/types";
5
+ import { NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationItem, NavigationRail, NavigationType } from "@ojiepermana/angular/navigation/types";
6
6
  /**
7
7
  * The identity shape the layout wrappers consume. The library defines the structure
8
8
  * only; the concrete brand and user values come from the consumer as inputs.
@@ -506,6 +506,8 @@ export declare class LayoutWrapperDefault {
506
506
  readonly navType: import("@angular/core").InputSignal<ThemeSettingsNavigationType>;
507
507
  /** Presentation mode for the active nav type (`collapsed` sidebar / `drawer` dockbar). */
508
508
  readonly navTypeMode: import("@angular/core").InputSignal<ThemeSettingsNavigationMode>;
509
+ /** Extent of parent to child rails in sidebar and dockbar menus. */
510
+ readonly navRail: import("@angular/core").InputSignal<NavigationRail>;
509
511
  /** Opt-in route-aware dockbar state; ignored by other navigation types. */
510
512
  readonly dockbarRouteContext: import("@angular/core").InputSignal<NavigationDockbarRouteContext$1 | null>;
511
513
  /** Registry badge untuk semua jenis navigasi desktop dan sidebar mobile. */
@@ -597,6 +599,11 @@ export declare class LayoutWrapperDefault {
597
599
  "required": false;
598
600
  "isSignal": true;
599
601
  };
602
+ "navRail": {
603
+ "alias": "nav-rail";
604
+ "required": false;
605
+ "isSignal": true;
606
+ };
600
607
  "dockbarRouteContext": {
601
608
  "alias": "dockbar-route-context";
602
609
  "required": false;
@@ -1,5 +1,6 @@
1
1
  import * as i0 from "@angular/core";
2
2
  import { EnvironmentProviders, InjectionToken, Signal, WritableSignal } from "@angular/core";
3
+ import { ON_FILL_INK, StorageResetStatus, foregroundFor } from "@ojiepermana/angular/component/utils/core";
3
4
  /**
4
5
  * One place for the "a preference that lives in localStorage and shows up as an
5
6
  * attribute on `<html>`" pattern that every theme axis needs.
@@ -212,7 +213,7 @@ export declare class ThemeColorService {
212
213
  private readonly options;
213
214
  private readonly colorAxis;
214
215
  private readonly neutralAxis;
215
- readonly color: import("@angular/core").Signal<"red" | "green" | "blue" | "base" | "orange" | "amber" | "yellow" | "lime" | "emerald" | "teal" | "cyan" | "sky" | "indigo" | "violet" | "purple" | "fuchsia" | "pink" | "rose" | "brand">;
216
+ readonly color: import("@angular/core").Signal<"base" | "red" | "orange" | "amber" | "yellow" | "lime" | "green" | "emerald" | "teal" | "cyan" | "sky" | "blue" | "indigo" | "violet" | "purple" | "fuchsia" | "pink" | "rose" | "brand">;
216
217
  readonly neutral: import("@angular/core").Signal<"base" | "slate" | "gray" | "zinc" | "neutral" | "stone" | "mauve" | "olive" | "mist" | "taupe">;
217
218
  setColor(color: ThemeColor): void;
218
219
  setNeutral(neutral: ThemeNeutral): void;
@@ -282,7 +283,13 @@ export interface ThemeBrandOptions {
282
283
  */
283
284
  readonly foreground?: string;
284
285
  }
286
+ export interface ThemeStorageResetOptions {
287
+ /** Exact, case-sensitive localStorage keys left untouched during a release reset. */
288
+ readonly preserveKeys?: readonly string[];
289
+ }
285
290
  export interface ThemeOptions {
291
+ /** Opt in to resetting localStorage on package upgrades. Disabled when omitted. */
292
+ readonly storageReset?: false | ThemeStorageResetOptions;
286
293
  readonly mode?: ThemeMode;
287
294
  /** Initial accent palette (`theme-color`). Persisted choice wins over this. */
288
295
  readonly color?: ThemeColor;
@@ -301,28 +308,25 @@ export interface ThemeOptions {
301
308
  }
302
309
  export declare const THEME_OPTIONS: InjectionToken<Readonly<ThemeOptions>>;
303
310
  export declare function provideUiTheme(options?: ThemeOptions): EnvironmentProviders;
304
- /**
305
- * The theme's dark ink per mode: `--foreground` of the base theme, which is what
306
- * a solid fill falls back to when white does not measure higher against it.
307
- *
308
- * Same values as `DARK_INK` in scripts/generators/gen-theme-colors.mjs, so a fill
309
- * the generator measured and a fill a consumer hands over at runtime get the
310
- * same answer. Read only.
311
- */
312
- export declare const ON_FILL_INK: Readonly<{
313
- readonly light: string;
314
- readonly dark: string;
315
- }>;
316
- /**
317
- * The text colour for a solid fill: white or the theme's dark ink
318
- * ({@link ON_FILL_INK}), whichever gives the higher WCAG ratio, with the ink
319
- * deepened step by step when neither reaches 4.5 to 1.
320
- *
321
- * `fill` is an HSL triplet (`'221 83% 53%'`) or a hex colour (`'#3b82f6'`).
322
- * Returns an HSL triplet for `hsl(<triplet>)`, or `null` when `fill` cannot be
323
- * read. The fill itself is never changed; only the foreground is chosen.
324
- *
325
- * The result equals the generator's for every canonical `H S% L%` input, which
326
- * scripts/generators/fixtures/on-fill-parity.json locks.
327
- */
328
- export declare function foregroundFor(fill: string, mode?: 'light' | 'dark'): string | null;
311
+ export declare const THEME_STORAGE_VERSION_KEY = "theme-storage-version";
312
+ type ThemeStorageResetStatus = StorageResetStatus;
313
+ /** Runs once before theme hydration; consumers in an initializer must await initialize(). */
314
+ export declare class ThemeStorageVersionService {
315
+ private readonly document;
316
+ private readonly injector;
317
+ private readonly destroyRef;
318
+ private readonly options;
319
+ private readonly preserved;
320
+ private readonly state;
321
+ private readonly coordinator;
322
+ private initialization?;
323
+ readonly status: import("@angular/core").Signal<StorageResetStatus>;
324
+ /** Called for every provider registration, so duplicate active roots cannot hide in one injector. */
325
+ registerRoot(active: boolean): void;
326
+ initialize(): Promise<void>;
327
+ private hydrate;
328
+ static ɵfac: i0.ɵɵFactoryDeclaration<ThemeStorageVersionService, never>;
329
+ static ɵprov: i0.ɵɵInjectableDeclaration<any>;
330
+ }
331
+ export declare const UI_THEME_RELEASE_VERSION: string;
332
+ export { ON_FILL_INK, type ThemeStorageResetStatus, foregroundFor };