@eagami/ui 5.74.0 → 5.76.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eagami/ui",
-  "version": "5.74.0",
+  "version": "5.76.0",
   "description": "Lightweight, accessible, themeable Angular UI component library and icon set built on CSS custom properties",
   "author": "Michal Wiraszka <michal@eagami.com>",
   "license": "MIT",
@@ -33,7 +33,13 @@
   "peerDependencies": {
     "@angular/common": "^21.0.0 || ^22.0.0",
     "@angular/core": "^21.0.0 || ^22.0.0",
-    "@angular/forms": "^21.0.0 || ^22.0.0"
+    "@angular/forms": "^21.0.0 || ^22.0.0",
+    "@angular/router": "^21.0.0 || ^22.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/router": {
+      "optional": true
+    }
   },
   "dependencies": {},
   "engines": {
@@ -49,6 +55,10 @@
       "types": "./types/eagami-ui.d.ts",
       "default": "./fesm2022/eagami-ui.mjs"
     },
+    "./router": {
+      "types": "./types/eagami-ui-router.d.ts",
+      "default": "./fesm2022/eagami-ui-router.mjs"
+    },
     "./testing": {
       "types": "./types/eagami-ui-testing.d.ts",
       "default": "./fesm2022/eagami-ui-testing.mjs"
@@ -61,6 +71,7 @@
     "src/styles",
     "schematics",
     "testing",
+    "router",
     "README.md"
   ],
   "schematics": "./schematics/collection.json"

package/router/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/eagami-ui-router.mjs",
+  "typings": "../types/eagami-ui-router.d.ts"
+}

package/schematics/collection.json

@@ -1,7 +1,7 @@
 {
   "schematics": {
     "ng-add": {
-      "description": "Set up Eagami UI: register the global stylesheet and fonts in an Angular workspace.",
+      "description": "Set up Eagami UI: register the global stylesheet, the fonts, and provideStaleBuildReload() in an Angular workspace.",
       "factory": "./ng-add/index#ngAdd",
       "schema": "./ng-add/schema.json"
     }

package/schematics/ng-add/index.js

@@ -2,10 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ngAdd = ngAdd;
 const schematics_1 = require("@angular-devkit/schematics");
+const utility_1 = require("@schematics/angular/utility");
 const workspace_1 = require("@schematics/angular/utility/workspace");
 const utils_1 = require("./utils");
 function ngAdd(options) {
-    return (0, schematics_1.chain)([registerStylesheet(options), registerFonts(options), logNextSteps()]);
+    return (0, schematics_1.chain)([
+        registerStylesheet(options),
+        registerFonts(options),
+        registerStaleBuildReload(options),
+        logNextSteps(),
+    ]);
 }
 function registerStylesheet(options) {
     return (0, workspace_1.updateWorkspace)(workspace => {
@@ -41,9 +47,15 @@ function registerFonts(options) {
         }
     };
 }
+function registerStaleBuildReload(options) {
+    return async (tree) => {
+        const { name } = findProject(await (0, workspace_1.getWorkspace)(tree), options.project);
+        return (0, utility_1.addRootProvider)(name, ({ code, external }) => code `${external('provideStaleBuildReload', '@eagami/ui/router')}()`);
+    };
+}
 function logNextSteps() {
     return (_tree, context) => {
-        context.logger.info('Eagami UI is set up: the global stylesheet and fonts are registered.');
+        context.logger.info('Eagami UI is set up: the global stylesheet and fonts are registered, and provideStaleBuildReload() reloads a tab left open across a deploy into the new build.');
         context.logger.info('Optional: call provideEagamiUi() in app.config.ts for a custom brand palette or extra locales.');
     };
 }

package/types/eagami-ui-router.d.ts

@@ -0,0 +1,54 @@
+import { EnvironmentProviders, InjectionToken } from "@angular/core";
+/**
+ * How a reload into the current build turned out:
+ *
+ * - `'recovered'`: the reloaded page opened
+ * - `'failed-after-reload'`: the reloaded page failed to open too, so the error is left to surface
+ * - `'stayed'`: the visitor chose to stay when the browser asked them to confirm leaving
+ */
+type StaleBuildReloadOutcome = 'recovered' | 'failed-after-reload' | 'stayed';
+interface StaleBuildReloadReport {
+  outcome: StaleBuildReloadOutcome;
+  /** The path that failed to open, without its query or fragment. */
+  route: string;
+  /** The `version` configured in the build that failed to open the page. */
+  fromVersion?: string;
+  /** The `version` configured in the build making the report. */
+  toVersion?: string;
+}
+interface StaleBuildReloadConfig {
+  /** The app's version, carried across the reload so a report names both builds. */
+  version?: string;
+  /** Called once per reload with how it turned out, for example to log it. */
+  onReport?: (report: StaleBuildReloadReport) => void;
+}
+declare const LOAD_PAGE: InjectionToken<(url: string, replace: boolean) => void>;
+/**
+ * Whether `error` is a failed page load that `provideStaleBuildReload()` has
+ * already answered by reloading. Error reporters can drop it, since the
+ * reload's outcome reaches `onReport` instead:
+ *
+ * ```ts
+ * Sentry.init({
+ *   beforeSend: (event, hint) =>
+ *     isStaleBuildReloadError(hint.originalException) ? null : event,
+ * });
+ * ```
+ */
+export declare function isStaleBuildReloadError(error: unknown): boolean;
+/**
+ * Loads the current build in full when the code of a page being opened fails
+ * to load, which is what a tab still running a build that a deploy has since
+ * replaced runs into. The reload opens the page the visitor asked for, and
+ * stops after one attempt if the new build fails as well.
+ *
+ * ```ts
+ * bootstrapApplication(AppComponent, {
+ *   providers: [provideRouter(routes), provideStaleBuildReload()],
+ * });
+ * ```
+ *
+ * Does nothing during server rendering.
+ */
+export declare function provideStaleBuildReload(config?: StaleBuildReloadConfig): EnvironmentProviders;
+export type { StaleBuildReloadConfig, StaleBuildReloadOutcome, StaleBuildReloadReport };

package/types/eagami-ui.d.ts

@@ -9138,8 +9138,8 @@ export declare function iconDisplayName(iconOrSlug: IconComponentType | string):
  * sorted by `slug` so that consumers iterating it (the `/ui/icons` reference
  * page, the sandbox gallery, downstream pickers) get a stable alphabetical
  * order where a base icon always precedes its `-2` variant (e.g. `facebook`
- * before `facebook-2`). The literal below is kept in class-name order so a new
- * icon has one obvious insertion point; the `.sort()` at the bottom is the
+ * before `facebook-2`). The imports and the class-name-ordered literal below
+ * are generated by `pnpm regen-docs`; the `.sort()` at the bottom is the
  * source of truth for consumers.
  *
  * Bundle-size note: importing this constant brings every icon component into
@@ -9435,6 +9435,13 @@ export declare class BanIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<BanIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<BanIconComponent, "ea-icon-ban", never, {}, {}, never, never, true, never>;
 }
+export declare class BanknoteIconComponent extends IconComponentBase {
+  static readonly slug = "banknote";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BanknoteIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BanknoteIconComponent, "ea-icon-banknote", never, {}, {}, never, never, true, never>;
+}
 export declare class BarChartIconComponent extends IconComponentBase {
   static readonly slug = "bar-chart";
   static readonly category: IconCategory;
@@ -9639,6 +9646,13 @@ export declare class BuildingIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<BuildingIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<BuildingIconComponent, "ea-icon-building", never, {}, {}, never, never, true, never>;
 }
+export declare class BusIconComponent extends IconComponentBase {
+  static readonly slug = "bus";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BusIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BusIconComponent, "ea-icon-bus", never, {}, {}, never, never, true, never>;
+}
 export declare class CakeIconComponent extends IconComponentBase {
   static readonly slug = "cake";
   static readonly category: IconCategory;
@@ -10480,6 +10494,13 @@ export declare class FileIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<FileIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FileIconComponent, "ea-icon-file", never, {}, {}, never, never, true, never>;
 }
+export declare class FileArchiveIconComponent extends IconComponentBase {
+  static readonly slug = "file-archive";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FileArchiveIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<FileArchiveIconComponent, "ea-icon-file-archive", never, {}, {}, never, never, true, never>;
+}
 export declare class FileAudioIconComponent extends IconComponentBase {
   static readonly slug = "file-audio";
   static readonly category: IconCategory;
@@ -10991,6 +11012,13 @@ export declare class InboxIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<InboxIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<InboxIconComponent, "ea-icon-inbox", never, {}, {}, never, never, true, never>;
 }
+export declare class IndentIconComponent extends IconComponentBase {
+  static readonly slug = "indent";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<IndentIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<IndentIconComponent, "ea-icon-indent", never, {}, {}, never, never, true, never>;
+}
 export declare class InfoIconComponent extends IconComponentBase {
   static readonly slug = "info";
   static readonly category: IconCategory;
@@ -11597,6 +11625,13 @@ export declare class OctagonIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<OctagonIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<OctagonIconComponent, "ea-icon-octagon", never, {}, {}, never, never, true, never>;
 }
+export declare class OutdentIconComponent extends IconComponentBase {
+  static readonly slug = "outdent";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<OutdentIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<OutdentIconComponent, "ea-icon-outdent", never, {}, {}, never, never, true, never>;
+}
 export declare class PackageIconComponent extends IconComponentBase {
   static readonly slug = "package";
   static readonly category: IconCategory;
@@ -11752,6 +11787,13 @@ export declare class PiggyBankIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<PiggyBankIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<PiggyBankIconComponent, "ea-icon-piggy-bank", never, {}, {}, never, never, true, never>;
 }
+export declare class PillIconComponent extends IconComponentBase {
+  static readonly slug = "pill";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PillIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PillIconComponent, "ea-icon-pill", never, {}, {}, never, never, true, never>;
+}
 export declare class PinIconComponent extends IconComponentBase {
   static readonly slug = "pin";
   static readonly category: IconCategory;
@@ -12134,6 +12176,13 @@ export declare class SaveIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SaveIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SaveIconComponent, "ea-icon-save", never, {}, {}, never, never, true, never>;
 }
+export declare class ScaleIconComponent extends IconComponentBase {
+  static readonly slug = "scale";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ScaleIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ScaleIconComponent, "ea-icon-scale", never, {}, {}, never, never, true, never>;
+}
 export declare class ScanIconComponent extends IconComponentBase {
   static readonly slug = "scan";
   static readonly category: IconCategory;
@@ -12289,6 +12338,41 @@ export declare class SidebarIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SidebarIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SidebarIconComponent, "ea-icon-sidebar", never, {}, {}, never, never, true, never>;
 }
+export declare class SignalFullIconComponent extends IconComponentBase {
+  static readonly slug = "signal-full";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalFullIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalFullIconComponent, "ea-icon-signal-full", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalHighIconComponent extends IconComponentBase {
+  static readonly slug = "signal-high";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalHighIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalHighIconComponent, "ea-icon-signal-high", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalLowIconComponent extends IconComponentBase {
+  static readonly slug = "signal-low";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalLowIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalLowIconComponent, "ea-icon-signal-low", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalMediumIconComponent extends IconComponentBase {
+  static readonly slug = "signal-medium";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalMediumIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalMediumIconComponent, "ea-icon-signal-medium", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalNoneIconComponent extends IconComponentBase {
+  static readonly slug = "signal-none";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalNoneIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalNoneIconComponent, "ea-icon-signal-none", never, {}, {}, never, never, true, never>;
+}
 export declare class SineWaveIconComponent extends IconComponentBase {
   static readonly slug = "sine-wave";
   static readonly category: IconCategory;
@@ -12382,6 +12466,20 @@ export declare class SoccerBallIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SoccerBallIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SoccerBallIconComponent, "ea-icon-soccer-ball", never, {}, {}, never, never, true, never>;
 }
+export declare class SortAscendingIconComponent extends IconComponentBase {
+  static readonly slug = "sort-ascending";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SortAscendingIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SortAscendingIconComponent, "ea-icon-sort-ascending", never, {}, {}, never, never, true, never>;
+}
+export declare class SortDescendingIconComponent extends IconComponentBase {
+  static readonly slug = "sort-descending";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SortDescendingIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SortDescendingIconComponent, "ea-icon-sort-descending", never, {}, {}, never, never, true, never>;
+}
 export declare class SparklesIconComponent extends IconComponentBase {
   static readonly slug = "sparkles";
   static readonly category: IconCategory;