@edsis/angular 22.2.11 → 22.2.14

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 (111) hide show
  1. package/fesm2022/edsis-angular-chart-area.mjs +3 -3
  2. package/fesm2022/edsis-angular-chart-bar.mjs +3 -3
  3. package/fesm2022/edsis-angular-chart-core.mjs +34 -34
  4. package/fesm2022/edsis-angular-chart-line.mjs +3 -3
  5. package/fesm2022/edsis-angular-chart-pie.mjs +3 -3
  6. package/fesm2022/edsis-angular-chart-primitives.mjs +33 -33
  7. package/fesm2022/edsis-angular-chart-radar.mjs +3 -3
  8. package/fesm2022/edsis-angular-chart-radial.mjs +3 -3
  9. package/fesm2022/edsis-angular-chart-scatter.mjs +3 -3
  10. package/fesm2022/edsis-angular-component-accordion.mjs +15 -15
  11. package/fesm2022/edsis-angular-component-alert-dialog.mjs +27 -27
  12. package/fesm2022/edsis-angular-component-alert.mjs +12 -12
  13. package/fesm2022/edsis-angular-component-aspect-ratio.mjs +3 -3
  14. package/fesm2022/edsis-angular-component-avatar.mjs +18 -18
  15. package/fesm2022/edsis-angular-component-badge.mjs +3 -3
  16. package/fesm2022/edsis-angular-component-breadcrumb.mjs +21 -21
  17. package/fesm2022/edsis-angular-component-button-group.mjs +9 -9
  18. package/fesm2022/edsis-angular-component-button.mjs +3 -3
  19. package/fesm2022/edsis-angular-component-calendar.mjs +3 -3
  20. package/fesm2022/edsis-angular-component-card.mjs +21 -21
  21. package/fesm2022/edsis-angular-component-carousel.mjs +18 -18
  22. package/fesm2022/edsis-angular-component-checkbox.mjs +3 -3
  23. package/fesm2022/edsis-angular-component-collapsible.mjs +12 -12
  24. package/fesm2022/edsis-angular-component-combobox.mjs +3 -3
  25. package/fesm2022/edsis-angular-component-command.mjs +27 -27
  26. package/fesm2022/edsis-angular-component-composer.mjs +21 -21
  27. package/fesm2022/edsis-angular-component-context-menu.mjs +3 -3
  28. package/fesm2022/edsis-angular-component-date-picker.mjs +3 -3
  29. package/fesm2022/edsis-angular-component-dialog.mjs +21 -21
  30. package/fesm2022/edsis-angular-component-dropdown-menu.mjs +39 -39
  31. package/fesm2022/edsis-angular-component-editor.mjs +18 -18
  32. package/fesm2022/edsis-angular-component-empty.mjs +18 -18
  33. package/fesm2022/edsis-angular-component-form.mjs +36 -36
  34. package/fesm2022/edsis-angular-component-hover-card.mjs +9 -9
  35. package/fesm2022/edsis-angular-component-icon.mjs +6 -6
  36. package/fesm2022/edsis-angular-component-input-group.mjs +18 -18
  37. package/fesm2022/edsis-angular-component-input-otp.mjs +15 -15
  38. package/fesm2022/edsis-angular-component-input.mjs +3 -3
  39. package/fesm2022/edsis-angular-component-item.mjs +30 -30
  40. package/fesm2022/edsis-angular-component-kanban.mjs +27 -27
  41. package/fesm2022/edsis-angular-component-kbd.mjs +6 -6
  42. package/fesm2022/edsis-angular-component-label.mjs +3 -3
  43. package/fesm2022/edsis-angular-component-menubar.mjs +12 -12
  44. package/fesm2022/edsis-angular-component-native-select.mjs +9 -9
  45. package/fesm2022/edsis-angular-component-navigation-menu.mjs +21 -21
  46. package/fesm2022/edsis-angular-component-pagination.mjs +3 -3
  47. package/fesm2022/edsis-angular-component-pillbox.mjs +15 -15
  48. package/fesm2022/edsis-angular-component-popover.mjs +6 -6
  49. package/fesm2022/edsis-angular-component-progress.mjs +3 -3
  50. package/fesm2022/edsis-angular-component-radio.mjs +6 -6
  51. package/fesm2022/edsis-angular-component-resizable.mjs +12 -12
  52. package/fesm2022/edsis-angular-component-scroll-area.mjs +3 -3
  53. package/fesm2022/edsis-angular-component-segmented-control.mjs +9 -7
  54. package/fesm2022/edsis-angular-component-select.mjs +6 -6
  55. package/fesm2022/edsis-angular-component-separator.mjs +3 -3
  56. package/fesm2022/edsis-angular-component-sheet.mjs +21 -21
  57. package/fesm2022/edsis-angular-component-skeleton.mjs +3 -3
  58. package/fesm2022/edsis-angular-component-slider.mjs +6 -6
  59. package/fesm2022/edsis-angular-component-spinner.mjs +3 -3
  60. package/fesm2022/edsis-angular-component-switch.mjs +3 -3
  61. package/fesm2022/edsis-angular-component-table.mjs +24 -24
  62. package/fesm2022/edsis-angular-component-tabs.mjs +18 -18
  63. package/fesm2022/edsis-angular-component-textarea.mjs +3 -3
  64. package/fesm2022/edsis-angular-component-timeline.mjs +18 -18
  65. package/fesm2022/edsis-angular-component-toast.mjs +3 -3
  66. package/fesm2022/edsis-angular-component-toggle-group.mjs +9 -9
  67. package/fesm2022/edsis-angular-component-toggle.mjs +3 -3
  68. package/fesm2022/edsis-angular-component-tooltip.mjs +15 -15
  69. package/fesm2022/edsis-angular-component-utils-core.mjs +420 -4
  70. package/fesm2022/edsis-angular-component-utils-scale.mjs +3 -3
  71. package/fesm2022/edsis-angular-navigation-icon.mjs +3 -3
  72. package/fesm2022/{edsis-angular-navigation-navigation-badge-count.component-D70Ju6_f.mjs → edsis-angular-navigation-navigation-badge-count.component-CLXtMyMX.mjs} +3 -3
  73. package/fesm2022/{edsis-angular-navigation-navigation-dockbar-menu.component-Wtnee3lp.mjs → edsis-angular-navigation-navigation-dockbar-menu.component-BNduIDrI.mjs} +30 -7
  74. package/fesm2022/{edsis-angular-navigation-navigation-entry-grid.component-CjxqB5LR.mjs → edsis-angular-navigation-navigation-entry-grid.component-CsD4tbBb.mjs} +60 -21
  75. package/fesm2022/{edsis-angular-navigation-navigation-flyout-menu.component-DGq4YT1o.mjs → edsis-angular-navigation-navigation-flyout-menu.component-Bs4PLVd6.mjs} +9 -7
  76. package/fesm2022/{edsis-angular-navigation-navigation-horizontal.component-CG8KNHK2.mjs → edsis-angular-navigation-navigation-horizontal.component-B1XQjUwa.mjs} +10 -8
  77. package/fesm2022/{edsis-angular-navigation-navigation-item.component-DLHZ8--d.mjs → edsis-angular-navigation-navigation-item.component-CIt0rwpl.mjs} +182 -55
  78. package/fesm2022/{edsis-angular-navigation-navigation-list.component-I8GW0_HG.mjs → edsis-angular-navigation-navigation-list.component-Dpre1l6O.mjs} +24 -4
  79. package/fesm2022/edsis-angular-navigation-service.mjs +7 -7
  80. package/fesm2022/edsis-angular-navigation.mjs +90 -66
  81. package/fesm2022/edsis-angular-theme-component-settings.mjs +88 -23
  82. package/fesm2022/edsis-angular-theme-layout-services.mjs +7 -7
  83. package/fesm2022/edsis-angular-theme-layout-wrapper.mjs +54 -30
  84. package/fesm2022/edsis-angular-theme-layout.mjs +26 -29
  85. package/fesm2022/edsis-angular-theme-on-fill.mjs +3 -3
  86. package/fesm2022/edsis-angular-theme-page-core.mjs +3 -3
  87. package/fesm2022/edsis-angular-theme-page-filter.mjs +6 -6
  88. package/fesm2022/edsis-angular-theme-page-overview.mjs +3 -3
  89. package/fesm2022/edsis-angular-theme-page-root.mjs +4 -3
  90. package/fesm2022/edsis-angular-theme-page-side.mjs +6 -6
  91. package/fesm2022/edsis-angular-theme-page-slots.mjs +12 -12
  92. package/fesm2022/edsis-angular-theme-shell-services.mjs +4 -4
  93. package/fesm2022/edsis-angular-theme-shell.mjs +10 -9
  94. package/fesm2022/edsis-angular-theme-styles.mjs +109 -178
  95. package/navigation/README.md +32 -2
  96. package/package.json +2 -2
  97. package/theme/component/settings/README.md +15 -0
  98. package/theme/styles/README.md +71 -1
  99. package/theme/styles/css/base/components.css +29 -75
  100. package/theme/styles/css/base/theme.css +3 -3
  101. package/theme/styles/css/base/tokens.css +8 -0
  102. package/types/edsis-angular-component-card.d.ts +1 -1
  103. package/types/edsis-angular-component-command.d.ts +1 -1
  104. package/types/edsis-angular-component-segmented-control.d.ts +3 -3
  105. package/types/edsis-angular-component-utils-core.d.ts +147 -3
  106. package/types/edsis-angular-navigation-types.d.ts +2 -0
  107. package/types/edsis-angular-navigation.d.ts +8 -1
  108. package/types/edsis-angular-theme-component-settings.d.ts +9 -1
  109. package/types/edsis-angular-theme-layout-wrapper.d.ts +9 -2
  110. package/types/edsis-angular-theme-layout.d.ts +0 -1
  111. package/types/edsis-angular-theme-styles.d.ts +30 -26
@@ -153,7 +153,7 @@ export declare function uniqueId(prefix: string): string;
153
153
  * `theme`, which already depends on navigation. Both already depend on this
154
154
  * entry point.
155
155
  */
156
- /** A storage that never throws. Missing storage reads as `null` and writes are dropped. */
156
+ /** Storage failures are ignored. An active reset gate rejects premature initialization. */
157
157
  export interface WebStorageRef {
158
158
  read(key: string): string | null;
159
159
  write(key: string, value: string): void;
@@ -166,10 +166,154 @@ export interface WebStorageRef {
166
166
  * part that can throw, and a storage that is blocked now may be available later
167
167
  * (or the other way round).
168
168
  */
169
- export declare function documentLocalStorage(documentRef: Document | null | undefined): WebStorageRef;
169
+ export declare function documentLocalStorage(documentRef: Document | null | undefined, owner?: {
170
+ readonly destroyed: boolean;
171
+ }): WebStorageRef;
170
172
  /**
171
173
  * `localStorage` from the global scope, for callers that only know whether they
172
174
  * are in a browser (the `isPlatformBrowser` flavour) rather than holding a
173
175
  * `Document`.
174
176
  */
175
- export declare function globalLocalStorage(isBrowser: boolean): WebStorageRef;
177
+ export declare function globalLocalStorage(isBrowser: boolean, owner?: {
178
+ readonly destroyed: boolean;
179
+ }): WebStorageRef;
180
+ /** Shared storage coordination. This entry point must not depend on theme or navigation. */
181
+ export declare const STORAGE_VERSION_KEY = "theme-storage-version";
182
+ export type StorageResetStatus = 'disabled' | 'pending' | 'ready' | 'adopted' | 'reset' | 'stale' | 'unavailable' | 'unsupported' | 'failed';
183
+ export declare function parseStorageVersion(value: string | null): readonly number[] | null;
184
+ /** Register even disabled roots, so conflicting registrations fail in either order. */
185
+ export declare function registerStorageRoot(documentRef: Document, coordinator: StorageCoordinator | null): () => void;
186
+ export declare function storageCoordinator(documentRef: Document | null | undefined): StorageCoordinator | null;
187
+ /** Native operations deliberately throw here; never use the forgiving wrapper during migration. */
188
+ export declare class StorageCoordinator {
189
+ private readonly documentRef;
190
+ private readonly version;
191
+ private readonly preserveKeys;
192
+ private readonly setStatus;
193
+ private state;
194
+ private readonly versionParts;
195
+ private readonly invalidations;
196
+ private readonly requests;
197
+ private tail;
198
+ private initialization?;
199
+ private destroyed;
200
+ private reloadPending;
201
+ private lastReloadTarget;
202
+ private readonly window;
203
+ constructor(documentRef: Document, version: string, preserveKeys: ReadonlySet<string>, setStatus: (status: StorageResetStatus) => void);
204
+ listen(): void;
205
+ initialize(hydrate: () => void): Promise<void>;
206
+ private bootstrap;
207
+ private nativeStorage;
208
+ private canPersist;
209
+ private assertInitialized;
210
+ read(key: string): string | null;
211
+ write(key: string, value: string, owner?: {
212
+ readonly destroyed: boolean;
213
+ }): void;
214
+ remove(key: string, owner?: {
215
+ readonly destroyed: boolean;
216
+ }): void;
217
+ private mutate;
218
+ onInvalidation(callback: () => void): () => void;
219
+ private transition;
220
+ private fail;
221
+ private observeMarker;
222
+ private lock;
223
+ private readonly onStorage;
224
+ private readonly onWake;
225
+ destroy(): void;
226
+ }
227
+ /**
228
+ * WCAG contrast math for tokens decided at runtime.
229
+ *
230
+ * A TypeScript port of scripts/generators/theme-contrast.mjs, which is where the built-in
231
+ * palettes are measured at generation time. The two halves have to agree: a
232
+ * brand a consumer sets through `ThemeBrandService` lands on `--primary` and
233
+ * `--ring` exactly like a generated accent does, so it is held to the same
234
+ * thresholds by the same formula rather than a second approximation of it.
235
+ *
236
+ * Everything works on the bare HSL triplet (`H S% L%`) the CSS consumes through
237
+ * `hsl(var(--token))`, so the numbers asserted are the numbers shipped. Parsing
238
+ * returns `null` instead of throwing, because the caller here is a setter on a
239
+ * running app and not a build step.
240
+ */
241
+ /** WCAG 1.4.3 minimum for normal-size text. */
242
+ export declare const TEXT_CONTRAST_MIN = 4.5;
243
+ /** WCAG 1.4.11 minimum for non-text contrast (focus rings, borders, icons). */
244
+ export declare const NON_TEXT_CONTRAST_MIN = 3;
245
+ /**
246
+ * Extra headroom used when solving for a lightness, so a value that only just
247
+ * clears the threshold cannot fail an assertion on a rounding difference.
248
+ */
249
+ export declare const SOLVE_MARGIN = 0.02;
250
+ export interface HslTriplet {
251
+ readonly h: number;
252
+ readonly s: number;
253
+ readonly l: number;
254
+ }
255
+ /** Read an HSL triplet string (`'221 83% 48%'`). `null` when it is not one. */
256
+ export declare function parseHslTriplet(value: string): HslTriplet | null;
257
+ /** Format numbers back into the triplet form the CSS consumes. */
258
+ export declare function formatHslTriplet({ h, s, l }: HslTriplet): string;
259
+ /** `#rgb` / `#rrggbb` as an HSL triplet. `null` when the input is not a hex color. */
260
+ export declare function hexToHslTriplet(value: string): string | null;
261
+ /** WCAG relative luminance of an HSL triplet, measured on the painted 8-bit colour. */
262
+ export declare function relativeLuminance(triplet: string): number;
263
+ /** WCAG contrast ratio between two HSL triplets. Order does not matter. */
264
+ export declare function contrastRatio(a: string, b: string): number;
265
+ /**
266
+ * Walk outward from `from` in 1% lightness steps and return the nearest
267
+ * lightness whose color clears `min` against every entry in `against`. Keeping
268
+ * hue and saturation fixed means the brand's identity survives; only how light
269
+ * it is moves, and it moves as little as the threshold allows.
270
+ *
271
+ * `against` is a list so a value that has to hold over more than one surface can
272
+ * be solved in one pass; the brand ring solves against one `--background` per
273
+ * mode, because it is painted per mode.
274
+ *
275
+ * `null` when no lightness in 0..100 satisfies every background.
276
+ */
277
+ export declare function solveLightnessNearest(options: {
278
+ readonly h: number;
279
+ readonly s: number;
280
+ readonly against: readonly string[];
281
+ readonly min: number;
282
+ readonly from: number;
283
+ readonly margin?: number;
284
+ }): string | null;
285
+ /**
286
+ * Keep a designed foreground when it already clears the threshold, otherwise
287
+ * nudge its lightness to the nearest value that does. Anything unparsable is
288
+ * returned untouched — there is nothing to measure.
289
+ */
290
+ export declare function fitForeground(options: {
291
+ readonly foreground: string;
292
+ readonly background: string;
293
+ readonly min?: number;
294
+ }): string;
295
+ /**
296
+ * The theme's dark ink per mode: `--foreground` of the base theme, which is what
297
+ * a solid fill falls back to when white does not measure higher against it.
298
+ *
299
+ * Same values as `DARK_INK` in scripts/generators/gen-theme-colors.mjs, so a fill
300
+ * the generator measured and a fill a consumer hands over at runtime get the
301
+ * same answer. Read only.
302
+ */
303
+ export declare const ON_FILL_INK: Readonly<{
304
+ readonly light: string;
305
+ readonly dark: string;
306
+ }>;
307
+ /**
308
+ * The text colour for a solid fill: white or the theme's dark ink
309
+ * ({@link ON_FILL_INK}), whichever gives the higher WCAG ratio, with the ink
310
+ * deepened step by step when neither reaches 4.5 to 1.
311
+ *
312
+ * `fill` is an HSL triplet (`'221 83% 53%'`) or a hex colour (`'#3b82f6'`).
313
+ * Returns an HSL triplet for `hsl(<triplet>)`, or `null` when `fill` cannot be
314
+ * read. The fill itself is never changed; only the foreground is chosen.
315
+ *
316
+ * The result equals the generator's for every canonical `H S% L%` input, which
317
+ * scripts/generators/fixtures/on-fill-parity.json locks.
318
+ */
319
+ export declare function foregroundFor(fill: string, mode?: 'light' | 'dark'): string | null;
@@ -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 "@edsis/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 "@edsis/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 "@edsis/angular/navigation/types";
5
5
  export * from "@edsis/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("@edsis/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 "@edsis/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 "@edsis/angular/theme/layout/types";
5
- import { NavigationType } from "@edsis/angular/navigation/types";
5
+ import { NavigationRail, NavigationType } from "@edsis/angular/navigation/types";
6
6
  import { ShellMode } from "@edsis/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).
@@ -165,6 +170,8 @@ export declare class ThemeSettingsDefaultAdapter implements ThemeSettingsAdapter
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>;
@@ -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 "@edsis/angular/theme/component/settings";
4
4
  import { NavigationDockbarRouteContext } from "@edsis/angular/navigation";
5
- import { NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationItem, NavigationType } from "@edsis/angular/navigation/types";
5
+ import { NavigationDockbarRouteContext as NavigationDockbarRouteContext$1, NavigationItem, NavigationRail, NavigationType } from "@edsis/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. */
@@ -555,7 +557,7 @@ export declare class LayoutWrapperDefault {
555
557
  /** Minidock only accepts flat data, so grouped data is flattened before it reaches the rail. */
556
558
  private readonly minidockData;
557
559
  /** Data id of the desktop `<Navigation>`; its state id stays `main` for persistence. */
558
- protected readonly desktopDataId: import("@angular/core").Signal<"main" | "main-minidock">;
560
+ protected readonly desktopDataId: import("@angular/core").Signal<"main-minidock" | "main">;
559
561
  /** Data of the desktop `<Navigation>`: flattened for minidock, unfiltered for every other type. */
560
562
  protected readonly desktopData: import("@angular/core").Signal<readonly NavigationItem[]>;
561
563
  /** Lebar host `<Navigation>`: penuh-tinggi (vertical) atau penuh-lebar (horizontal). */
@@ -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;
@@ -3,7 +3,6 @@ import * as i0 from "@angular/core";
3
3
  import { LAYOUT_APPEARANCES, LAYOUT_APPEARANCE_STORAGE_KEY, LAYOUT_DEFAULT_APPEARANCE, LAYOUT_DEFAULT_SURFACE, LAYOUT_DEFAULT_TYPE, LAYOUT_DEFAULT_WIDTH, LAYOUT_LOCKED_WIDTH, LAYOUT_SURFACES, LAYOUT_SURFACE_STORAGE_KEY, LAYOUT_TYPES, LAYOUT_TYPE_STORAGE_KEY, LAYOUT_WIDTHS, LAYOUT_WIDTH_STORAGE_KEY, LayoutAppearance, LayoutContextValue, LayoutSurface, LayoutType, LayoutWidth, isUiLayoutAppearance, isUiLayoutSurface, isUiLayoutType, isUiLayoutWidth } from "@edsis/angular/theme/layout/types";
4
4
  export declare class LayoutComponent {
5
5
  protected readonly layout: LayoutService$1;
6
- private readonly themeRadius;
7
6
  readonly surface: import("@angular/core").InputSignal<"flat" | "grid" | "grid-line" | "honeycomb" | "matrix" | "circuit" | "line-vertical" | "line-horizontal" | null>;
8
7
  readonly appearance: import("@angular/core").InputSignal<"flat" | "border-rail" | null>;
9
8
  readonly layoutAppearanceAttribute: import("@angular/core").InputSignal<"flat" | "border-rail" | null>;
@@ -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 "@edsis/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 };