@rblabs-dev/axiom 1.2.1 → 1.2.3

package/fonts/LICENSE

@@ -0,0 +1,93 @@
+Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter) Inter-Italic[opsz,wght].ttf: Copyright 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/message/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-message.mjs",
+  "typings": "../types/rblabs-dev-axiom-message.d.ts"
+}

package/monogram/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-monogram.mjs",
+  "typings": "../types/rblabs-dev-axiom-monogram.d.ts"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rblabs-dev/axiom",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Axiom, the RB Labs design system for Angular and Angular Material 3",
   "keywords": [
     "angular",
@@ -31,9 +31,69 @@
     "./package.json": {
       "default": "./package.json"
     },
+    "./app-shell": {
+      "types": "./types/rblabs-dev-axiom-app-shell.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-app-shell.mjs"
+    },
+    "./brand-lockup": {
+      "types": "./types/rblabs-dev-axiom-brand-lockup.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-brand-lockup.mjs"
+    },
+    "./central-sign-in": {
+      "types": "./types/rblabs-dev-axiom-central-sign-in.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-central-sign-in.mjs"
+    },
+    "./confirm-dialog": {
+      "types": "./types/rblabs-dev-axiom-confirm-dialog.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-confirm-dialog.mjs"
+    },
+    "./core": {
+      "types": "./types/rblabs-dev-axiom-core.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-core.mjs"
+    },
+    "./empty-state": {
+      "types": "./types/rblabs-dev-axiom-empty-state.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-empty-state.mjs"
+    },
+    "./message": {
+      "types": "./types/rblabs-dev-axiom-message.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-message.mjs"
+    },
+    "./monogram": {
+      "types": "./types/rblabs-dev-axiom-monogram.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-monogram.mjs"
+    },
+    "./page-header": {
+      "types": "./types/rblabs-dev-axiom-page-header.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-page-header.mjs"
+    },
+    "./panel": {
+      "types": "./types/rblabs-dev-axiom-panel.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-panel.mjs"
+    },
+    "./public-shell": {
+      "types": "./types/rblabs-dev-axiom-public-shell.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-public-shell.mjs"
+    },
+    "./shell-footer": {
+      "types": "./types/rblabs-dev-axiom-shell-footer.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-shell-footer.mjs"
+    },
     "./showcase": {
       "types": "./types/rblabs-dev-axiom-showcase.d.ts",
       "default": "./fesm2022/rblabs-dev-axiom-showcase.mjs"
+    },
+    "./status-chip": {
+      "types": "./types/rblabs-dev-axiom-status-chip.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-status-chip.mjs"
+    },
+    "./technical-value": {
+      "types": "./types/rblabs-dev-axiom-technical-value.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-technical-value.mjs"
+    },
+    "./theme-toggle": {
+      "types": "./types/rblabs-dev-axiom-theme-toggle.d.ts",
+      "default": "./fesm2022/rblabs-dev-axiom-theme-toggle.mjs"
     }
   },
   "bin": {
@@ -42,8 +102,24 @@
   "files": [
     "fesm2022",
     "types",
+    "app-shell",
+    "brand-lockup",
+    "central-sign-in",
+    "confirm-dialog",
+    "core",
+    "empty-state",
+    "message",
+    "monogram",
+    "page-header",
+    "panel",
+    "public-shell",
+    "shell-footer",
     "showcase",
+    "status-chip",
+    "technical-value",
+    "theme-toggle",
     "styles",
+    "fonts",
     "brand",
     "material-symbols-icons.txt",
     "cli"
@@ -59,7 +135,6 @@
     "rxjs": "^7.8.0"
   },
   "dependencies": {
-    "@fontsource-variable/inter": "^5.3.0",
     "tslib": "^2.3.0"
   },
   "sideEffects": false,

package/page-header/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-page-header.mjs",
+  "typings": "../types/rblabs-dev-axiom-page-header.d.ts"
+}

package/panel/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-panel.mjs",
+  "typings": "../types/rblabs-dev-axiom-panel.d.ts"
+}

package/public-shell/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-public-shell.mjs",
+  "typings": "../types/rblabs-dev-axiom-public-shell.d.ts"
+}

package/shell-footer/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-shell-footer.mjs",
+  "typings": "../types/rblabs-dev-axiom-shell-footer.d.ts"
+}

package/status-chip/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-status-chip.mjs",
+  "typings": "../types/rblabs-dev-axiom-status-chip.d.ts"
+}

package/styles/_fonts.scss

@@ -1,17 +1,18 @@
 // Self-hosted fonts (docs/design-system.md, sections 6.1 and 10). Nothing here loads from a CDN:
-// Inter Variable is bundled from @fontsource-variable/inter, and the Material Symbols subset is
-// served by the app from public/fonts/.
+// the app serves Inter Variable from the package's fonts/ folder and its Material Symbols subset
+// from public/fonts/, both at /fonts/.
 
 // Inter Variable, Latin and Latin Extended. `optional` paints with the system fallback at once on a
-// slow network instead of delaying or reflowing the first render.
+// slow network instead of delaying or reflowing the first render. The URLs are stable so that the
+// app's index.html can preload the Latin file: the font then loads with the HTML instead of after
+// the global stylesheet, which a first visit needs to get Inter within the `optional` window.
 @mixin inter() {
   @font-face {
     font-family: 'Inter Variable';
     font-style: normal;
     font-display: optional;
     font-weight: 100 900;
-    src: url('@fontsource-variable/inter/files/inter-latin-wght-normal.woff2')
-      format('woff2-variations');
+    src: url('/fonts/inter-latin-wght-normal.woff2') format('woff2-variations');
     unicode-range:
       U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329,
       U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
@@ -22,8 +23,7 @@
     font-style: normal;
     font-display: optional;
     font-weight: 100 900;
-    src: url('@fontsource-variable/inter/files/inter-latin-ext-wght-normal.woff2')
-      format('woff2-variations');
+    src: url('/fonts/inter-latin-ext-wght-normal.woff2') format('woff2-variations');
     unicode-range:
       U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329,
       U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F,

package/styles/_index.scss

@@ -27,7 +27,7 @@
 @forward 'breakpoints' show below, above, $breakpoints;
 
 // Stamped from projects/axiom/package.json by the build (scripts/stamp-version.mjs).
-$version: '1.2.1';
+$version: '1.2.3';
 
 @mixin design-system($scope: null, $icon-font-url: null) {
   @include fonts.inter();

package/technical-value/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-technical-value.mjs",
+  "typings": "../types/rblabs-dev-axiom-technical-value.d.ts"
+}

package/theme-toggle/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/rblabs-dev-axiom-theme-toggle.mjs",
+  "typings": "../types/rblabs-dev-axiom-theme-toggle.d.ts"
+}

package/types/rblabs-dev-axiom-app-shell.d.ts

@@ -0,0 +1,50 @@
+import * as i0 from "@angular/core";
+/**
+ * `sidenav`: a navigation rail beside the content that becomes a drawer below `lg`.
+ * `modules`: a short list of sections beside the content that becomes a row, then a tab bar.
+ * `none`: top-level links, if any, go in the `[rbShellActions]` slot.
+ */
+export type RbAppShellNavigation = 'none' | 'sidenav' | 'modules';
+/**
+ * Frame for authenticated and operational areas (docs/design-system.md, section 16.1): skip link,
+ * top bar with the brand lockup, title, actions and theme toggle, optional navigation, the content
+ * column and the standard footer.
+ */
+export declare class RbAppShellComponent {
+  /** Shown in the lockup and the footer: `Admin`, `Auth`, `Rover`, `Photogrammetry`… */
+  readonly appName: import("@angular/core").InputSignal<string>;
+  /** The lockup's link target, as a `routerLink` value. */
+  readonly homeLink: import("@angular/core").InputSignal<string | readonly unknown[]>;
+  readonly navigation: import("@angular/core").InputSignal<RbAppShellNavigation>;
+  protected readonly hasSidenav: import("@angular/core").Signal<boolean>;
+  private readonly breakpointObserver;
+  /** Below `lg` the sidenav is an overlay drawer (section 8.1). */
+  readonly isDrawer: import("@angular/core").WritableSignal<boolean>;
+  readonly drawerOpen: import("@angular/core").WritableSignal<boolean>;
+  private readonly main;
+  constructor();
+  toggleDrawer(): void;
+  /**
+   * Moves focus to `<main>` without changing the URL: with `<base href="/">` a bare `#main-content`
+   * link would resolve to the root route instead of the current page.
+   */
+  protected skipToMain(event: Event): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RbAppShellComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RbAppShellComponent, "rb-app-shell", never, {
+    "appName": {
+      "alias": "appName";
+      "required": true;
+      "isSignal": true;
+    };
+    "homeLink": {
+      "alias": "homeLink";
+      "required": false;
+      "isSignal": true;
+    };
+    "navigation": {
+      "alias": "navigation";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["[rbShellTitle]", "[rbShellActions]", "[rbShellSidenav]", "[rbShellModuleNav]", "*", "[rbShellFooter]"], true, never>;
+}

package/types/rblabs-dev-axiom-brand-lockup.d.ts

@@ -0,0 +1,35 @@
+import * as i0 from "@angular/core";
+/** `true` shows only the monogram; `'below-sm'` does so only below the `sm` breakpoint. */
+export type RbBrandLockupCompact = boolean | 'below-sm';
+/**
+ * The RB monogram followed by "RB Labs · <App name>", as a link to the app's home
+ * (docs/design-system.md, section 12.2). The accessible name stays "RB Labs <App name> home" in
+ * every variant.
+ */
+export declare class RbBrandLockupComponent {
+  /** `Admin`, `Auth`, `Rover`, `Photogrammetry` or a new app's name. */
+  readonly appName: import("@angular/core").InputSignal<string>;
+  /** The app's home, as a `routerLink` value. */
+  readonly link: import("@angular/core").InputSignal<string | readonly unknown[]>;
+  readonly compact: import("@angular/core").InputSignalWithTransform<RbBrandLockupCompact, "" | RbBrandLockupCompact>;
+  protected readonly accessibleName: import("@angular/core").Signal<string>;
+  protected readonly compactAttribute: import("@angular/core").Signal<"below-sm" | "always" | null>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RbBrandLockupComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RbBrandLockupComponent, "rb-brand-lockup", never, {
+    "appName": {
+      "alias": "appName";
+      "required": true;
+      "isSignal": true;
+    };
+    "link": {
+      "alias": "link";
+      "required": false;
+      "isSignal": true;
+    };
+    "compact": {
+      "alias": "compact";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}

package/types/rblabs-dev-axiom-central-sign-in.d.ts

@@ -0,0 +1,82 @@
+import * as i0 from "@angular/core";
+/**
+ * The central sign-in page (docs/design-system.md, section 16.3): one card that hands the user off
+ * to RB Labs Auth. Apps that sign in through Auth place it alone in `rb-public-shell`; it renders
+ * the page's single `<h1>`, collects no credentials and emits `signIn` for the app to start the
+ * handoff with its own return path.
+ */
+export declare class RbCentralSignInComponent {
+  /** The app the user signs in to: `Admin`, `Rover`, `Photogrammetry`… */
+  readonly appName: import("@angular/core").InputSignal<string>;
+  /** Overrides the default title, `Sign in to RB Labs <appName>`. */
+  readonly title: import("@angular/core").InputSignal<string>;
+  /** Short context above the title, such as the workspace the page protects. */
+  readonly eyebrow: import("@angular/core").InputSignal<string>;
+  /** Overrides the default sentence about where the user is sent. */
+  readonly description: import("@angular/core").InputSignal<string>;
+  /** Material Symbols name of the app's icon in the card header. */
+  readonly icon: import("@angular/core").InputSignal<string>;
+  /** Host shown in the identity row. */
+  readonly authHost: import("@angular/core").InputSignal<string>;
+  /** Optional closing note, such as who may enter the app. */
+  readonly note: import("@angular/core").InputSignal<string>;
+  /** A safe, non-disclosing message for the failure the app was sent back with. */
+  readonly error: import("@angular/core").InputSignal<string | null>;
+  /** The "Back to home" target, as a `routerLink` value. */
+  readonly backLink: import("@angular/core").InputSignal<string | readonly unknown[]>;
+  /** The primary action: the app starts the Auth handoff with its return path. */
+  readonly signIn: import("@angular/core").OutputEmitterRef<void>;
+  protected readonly titleId: string;
+  protected readonly resolvedTitle: import("@angular/core").Signal<string>;
+  protected readonly resolvedDescription: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RbCentralSignInComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RbCentralSignInComponent, "rb-central-sign-in", never, {
+    "appName": {
+      "alias": "appName";
+      "required": true;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "eyebrow": {
+      "alias": "eyebrow";
+      "required": false;
+      "isSignal": true;
+    };
+    "description": {
+      "alias": "description";
+      "required": false;
+      "isSignal": true;
+    };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
+    "authHost": {
+      "alias": "authHost";
+      "required": false;
+      "isSignal": true;
+    };
+    "note": {
+      "alias": "note";
+      "required": false;
+      "isSignal": true;
+    };
+    "error": {
+      "alias": "error";
+      "required": false;
+      "isSignal": true;
+    };
+    "backLink": {
+      "alias": "backLink";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "signIn": "signIn";
+  }, never, never, true, never>;
+}

package/types/rblabs-dev-axiom-confirm-dialog.d.ts

@@ -0,0 +1,76 @@
+import { FormControl } from "@angular/forms";
+import * as i0 from "@angular/core";
+export type RbConfirmDialogTone = 'primary' | 'danger';
+export interface RbConfirmDialogReason {
+  /** Visible label of the reason field. Defaults to "Reason". */
+  label?: string;
+  /** Helper text under the field. */
+  hint?: string;
+  /** Minimum length of the trimmed reason. Defaults to 3. */
+  minimumLength?: number;
+}
+export interface RbConfirmDialogData {
+  title: string;
+  description: string;
+  confirmLabel: string;
+  /** Defaults to "Cancel". */
+  cancelLabel?: string;
+  /** `danger` is for destructive or irreversible actions. Defaults to `primary`. */
+  tone?: RbConfirmDialogTone;
+  /** Asks for a required reason, returned trimmed in the result. */
+  reason?: RbConfirmDialogReason;
+}
+export interface RbConfirmDialogResult {
+  confirmed: boolean;
+  reason?: string;
+}
+/** Data the service adds so the dialog container can reference the description. */
+export interface RbConfirmDialogInternalData extends RbConfirmDialogData {
+  descriptionId?: string;
+}
+/** Generates the ids shared by the service (dialog config) and the dialog content. */
+export declare function rbConfirmDialogId(): string;
+/**
+ * Confirmation content opened by `RbConfirmDialogService` (docs/design-system.md, section 15.7).
+ * Use the service rather than opening this component directly.
+ */
+export declare class RbConfirmDialogComponent {
+  protected readonly data: RbConfirmDialogInternalData;
+  private readonly dialogRef;
+  private readonly reasonInput;
+  private readonly id;
+  protected readonly descriptionId: string;
+  protected readonly reasonId: string;
+  protected readonly tone: RbConfirmDialogTone;
+  protected readonly minimumReasonLength: number;
+  private readonly trimmedMinLength;
+  protected readonly reason: FormControl<string>;
+  private readonly submitted;
+  protected showReasonError(): boolean;
+  protected reasonDescribedBy(): string | null;
+  cancel(): void;
+  confirm(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RbConfirmDialogComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RbConfirmDialogComponent, "rb-confirm-dialog", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Asks the user to confirm an action (docs/design-system.md, section 15.7):
+ *
+ * ```ts
+ * const { confirmed, reason } = await confirmDialog.confirm({
+ *   title: 'Revoke credential?',
+ *   description: 'Clients using it stop working immediately.',
+ *   confirmLabel: 'Revoke credential',
+ *   tone: 'danger',
+ *   reason: { label: 'Reason for revoking' },
+ * });
+ * ```
+ *
+ * Closing the dialog in any other way (Cancel, Escape, the backdrop) resolves `confirmed: false`.
+ */
+export declare class RbConfirmDialogService {
+  private readonly dialog;
+  confirm(data: RbConfirmDialogData): Promise<RbConfirmDialogResult>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RbConfirmDialogService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}