@hermes-ui/angular 0.1.4

package/types/hermes-ui-angular-addons-theme-builder.d.ts

@@ -0,0 +1,200 @@
+import * as i0 from '@angular/core';
+import { OnInit, AfterViewInit, EventEmitter, ElementRef } from '@angular/core';
+import { HermesTimelineStepState } from '@hermes-ui/angular';
+
+interface WcagLevel {
+    label: string;
+    score: string;
+    type: string;
+}
+interface ContrastResult {
+    minContrast: {
+        wcag: WcagLevel;
+        score: number;
+    };
+    backgrounds: {
+        name: string;
+        score: number;
+        wcag: WcagLevel;
+    }[];
+}
+/**
+ * Per-theme lookup keyed by token group / background name. Defaults to grouped
+ * color variants (`Color[]`, used by `colorStruct`); pass `Color` for single-value
+ * structures like `backgrounds`.
+ */
+type HermesThemeStructure<T = Color[]> = {
+    light: Record<string, T>;
+    dark: Record<string, T>;
+};
+/** HSL color: hue wraps to 0–360, saturation/lightness clamp to 0–100. */
+declare class HslColor {
+    readonly h: number;
+    readonly s: number;
+    readonly l: number;
+    constructor(h: number, s: number, l: number);
+}
+/** RGB color: red/green/blue clamp to 0–255 and round to whole channel values. */
+declare class RgbColor {
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+    constructor(r: number, g: number, b: number);
+}
+/** OKLCH color: lightness clamps to 0–1, chroma clamps to ≥0, hue wraps to 0–360. */
+declare class OklchColor {
+    readonly l: number;
+    readonly c: number;
+    readonly h: number;
+    constructor(l: number, c: number, h: number);
+}
+interface ThemeColors {
+    primary?: Color;
+    info?: Color;
+    success?: Color;
+    warning?: Color;
+    danger?: Color;
+}
+interface ThemePreset {
+    name: string;
+    light: ThemeColors;
+    dark: ThemeColors;
+}
+interface ThemeColor {
+    key: string;
+    base: Color;
+    variants: Color[];
+    contrast: ContrastResult;
+}
+interface DataRow {
+    name: string;
+    role: string;
+    status: string;
+}
+
+/**
+ * A single theme token: its CSS custom property name, the original Clarity-provided
+ * HSL value, and the current (possibly user-edited) color. Colors are stored in HSL;
+ * RGB and HEX are derived on demand.
+ */
+declare class Color {
+    name: string;
+    originalColor: string;
+    private _color?;
+    /**
+     * @param name CSS custom property name, e.g. `--hermes-alias-status-info`
+     * @param originalColor Clarity-provided HSL, e.g. `hsl(198deg 100% 59%)`
+     */
+    constructor(name: string, originalColor: string);
+    /** HSL components. Falls back to parsing `originalColor` when not explicitly set. */
+    get color(): HslColor;
+    set color(value: HslColor);
+    /** RGB components — HSL is converted to RGB only for relative luminance checks. */
+    get rgb(): RgbColor;
+    /** HEX string — used by native color inputs. */
+    get hex(): string;
+    /** HSL string — used by native color inputs. */
+    get hsl(): string;
+    /**
+     * OKLCH components — unlike HSL's `L`, OKLCH's `L` tracks perceived lightness
+     * uniformly across all hues, which is why it's used for palette/contrast math.
+     */
+    get oklch(): OklchColor;
+    /** OKLCH string, CSS Color 4 syntax. */
+    get oklchString(): string;
+    /** Human-readable variant label derived from the token name suffix, e.g. `Tint dark`. */
+    get label(): string;
+    get isOriginalColor(): boolean;
+    static isHex(hex: string): boolean;
+    static shiftL({ h, s, l }: HslColor, delta: number): HslColor;
+    static hexToHsl(hex: string): HslColor;
+    /**
+     * Converts HSL to OKLCH via linear sRGB and OKLab (CSS Color 4 / Björn Ottosson
+     * formulas). Goes through OKLCH — not raw HSL — whenever perceptual uniformity
+     * matters, since HSL's `L` looks lighter or darker depending on hue.
+     */
+    hslToOklch(hsl: HslColor): OklchColor;
+    reset(): void;
+    private hslToHex;
+    /** Converts HSL to RGB — use only for relative luminance calculations. */
+    private hslToRgb;
+    /** Converts linear sRGB (0–1 channels) to OKLab. */
+    private linearSrgbToOklab;
+    /** Parses a CSS HSL string such as `hsl(198deg 100% 59%)`. */
+    private parseHsl;
+}
+
+declare class ThemeBuilderComponent implements OnInit, AfterViewInit {
+    /** Emits the generated CSS override text whenever a color, preset, reset, or override toggle changes. */
+    generatedCSS: EventEmitter<string>;
+    previewWrapper: ElementRef<HTMLElement>;
+    previewDarkWrapper: ElementRef<HTMLElement>;
+    activePreset: ThemePreset | null;
+    activeTheme: 'light' | 'dark';
+    warningTextOverrideEnabled: boolean;
+    colorStruct: HermesThemeStructure;
+    backgrounds: HermesThemeStructure<Color>;
+    themeColors: ThemeColor[];
+    breadcrumbs: {
+        label: string;
+        href: string;
+    }[];
+    wizardOpen: boolean;
+    rows: DataRow[];
+    description: string;
+    stepperForm: {
+        account: {
+            fullName: string;
+        };
+        confirm: {
+            agree: boolean;
+        };
+    };
+    readonly timelineStates: typeof HermesTimelineStepState;
+    private _presets;
+    constructor();
+    /**
+     * Presets available in the preset selector. Defaults to Hermes's built-in preset list.
+     * The default (Evergreen) preset is always prepended, so it's guaranteed to remain available
+     * as a fallback even when a custom list is provided.
+     */
+    get presets(): ThemePreset[];
+    set presets(value: ThemePreset[]);
+    get isDarkTheme(): boolean;
+    get generatedCss(): string;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    toggleActiveTheme(): void;
+    setCurrentColor(colorVariant: Color, hex: string, colorGroup?: Color[]): void;
+    applyPreset(preset: ThemePreset): void;
+    resetAllThemeColors(theme: string): void;
+    resetColor($event: Event, color: Color, colorGroup?: Color[]): void;
+    onWarningTextOverrideChange(): void;
+    applyPreviewStyles(): void;
+    private getContrast;
+    private refreshThemeColors;
+    private resetActivePreset;
+    private colorBuilder;
+    private buildColorStructure;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ThemeBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ThemeBuilderComponent, "hermes-theme-builder", never, { "presets": { "alias": "presets"; "required": false; }; }, { "generatedCSS": "generatedCSS"; }, never, ["*"], true, never>;
+}
+
+/**
+ * Applies a theme-builder preset's colors directly onto `el` as inline CSS custom properties —
+ * the same mechanism `ThemeBuilderComponent` uses on its own preview sandbox. An inline style
+ * always outranks the attribute-selector rules that ship the default/dark-theme tokens, so this
+ * reskins whatever `el` themes (e.g. `document.body` reskins the whole page).
+ *
+ * Pass the identity preset (`light`/`dark`: null, see `DEFAULT_PRESET`) to clear every override
+ * and fall back to the shipped defaults.
+ */
+declare function applyThemePreset(el: HTMLElement, preset: ThemePreset, theme: 'light' | 'dark'): void;
+
+/** The default (Evergreen) theme. Acts as the identity preset that resets every color back to its shipped value. */
+declare const DEFAULT_PRESET: ThemePreset;
+declare const PRESETS: ThemePreset[];
+
+export { Color, DEFAULT_PRESET, PRESETS, ThemeBuilderComponent, applyThemePreset };
+export type { ThemeColor, ThemeColors, ThemePreset };
+//# sourceMappingURL=hermes-ui-angular-addons-theme-builder.d.ts.map

package/types/hermes-ui-angular-addons-theme-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-ui-angular-addons-theme-builder.d.ts","sources":["../../../addons/theme-builder/utils/types.ts","../../../addons/theme-builder/utils/color.ts","../../../addons/theme-builder/theme-builder.component.ts","../../../addons/theme-builder/utils/apply-preset.ts","../../../addons/theme-builder/utils/presets.ts"],"mappings":";;;;UASiB,SAAS;;;;AAIzB;UAEgB,cAAc;AAC7B;cAAqB,SAAS;;;AAC9B;;;cAAkD,SAAS;AAAE;AAC9D;AAED;;;;AAIG;KACS,oBAAoB,KAAK,KAAK;AAAQ,WAAO,MAAM;AAAa,UAAM,MAAM;;AAWxF;AACA,cAAa,QAAQ;AACnB;AACA;AACA;;AAOD;AAED;AACA,cAAa,QAAQ;AACnB;AACA;AACA;;AAOD;AAqBD;AACA,cAAa,UAAU;AACrB;AACA;AACA;;AAOD;UAegB,WAAW;cAChB,KAAK;WACR,KAAK;cACF,KAAK;cACL,KAAK;aACN,KAAK;AACf;UAEgB,WAAW;;WAEnB,WAAW;UACZ,WAAW;AAClB;UAEgB,UAAU;;UAEnB,KAAK;cACD,KAAK;cACL,cAAc;AACzB;UAEgB,OAAO;;;;AAIvB;;AC3HD;;;;AAIG;AACH,cAAa,KAAK;AAQP;AACA;;AANT;;;AAGG;AAEM;;iBAKI,QAAQ;AAIrB,qBAAiB,QAAQ;;eAKd,QAAQ;;;;;AAenB;;;AAGG;iBACU,UAAU;;;;;;AAwCvB;AAIA,+BAA2B,QAAQ,kBAAkB,QAAQ;AAI7D,kCAA8B,QAAQ;AAiCtC;;;;AAIG;AACH,oBAAgB,QAAQ,GAAG,UAAU;AAUrC;AAIA;;AAcA;;AAWA;;AAaA;AAID;;AClKD,cAMa,qBAAsB,YAAW,MAAM,EAAE,aAAa;;AAEvD,kBAAY,YAAA;AAEO,oBAAiB,UAAU,CAAC,WAAW;AACnC,wBAAqB,UAAU,CAAC,WAAW;AAI5E,kBAAc,WAAW;AAEzB;AAGA;iBAEa,oBAAoB;AAKjC,iBAAa,oBAAoB,CAAC,KAAK;iBAK1B,UAAU;;;;AAOrB;AACF;UACM,OAAO;;;;;;;;;AAKX;oCAEqB,uBAAA;;;AAQvB;;;;AAIG;AACH,mBACe,WAAW;AAI1B,uBAAmB,WAAW;;;AAY9B;AAIA;AAMA;AAOA,kCAA8B,KAAK,4BAA2B,KAAK;AAYnE,wBAAoB,WAAW;;AAsC/B,uBAAmB,KAAK,SAAS,KAAK,eAAc,KAAK;AAazD;AAKA;AAwCA;AA0BA;AAoBA;AAWA;AAkBA;yCAhRW,qBAAqB;2CAArB,qBAAqB;AA+SjC;;AC5SD;;;;;;;;AAQG;AACH,iBAAgB,gBAAgB,KAAK,WAAW,UAAU,WAAW;;AC8FrE;AACA,cAAa,cAAc,EAAE,WAI5B;AAED,cAAa,OAAO,EAAE,WAAW;;","names":[]}

package/types/hermes-ui-angular-addons-translate.d.ts

@@ -0,0 +1,149 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, PipeTransform } from '@angular/core';
+import { Observable } from 'rxjs';
+import * as i3 from '@angular/common';
+
+type AppfxTranslations = Readonly<Record<AppfxLocale, Readonly<Record<string, string>>>>;
+type InterpolationParams = Readonly<Record<string, unknown>>;
+type EmptyTranslationCallback = (translations: AppfxTranslations, locale: AppfxLocale, key: string, args?: InterpolationParams) => string;
+/**
+ * Injection token which provides the translation strings.
+ */
+declare const appfxTranslationsToken: InjectionToken<Readonly<Record<AppfxLocale, Readonly<Record<string, string>>>>>;
+/**
+ * Injection token which overrides the default behavior for a missing translation string.
+ */
+declare const appfxMissingTranslationToken: InjectionToken<EmptyTranslationCallback>;
+/**
+ * The default appfxMissingTranslation handler.
+ *
+ * Tries to translate into Locale.En and if that fails then the key is returned.
+ */
+declare function defaultMissingTranslationHandler(translations: AppfxTranslations, locale: AppfxLocale, key: string): string;
+/**
+ * Supported locales in AppFx.
+ */
+declare enum AppfxLocale {
+    En = "en",
+    Es = "es",
+    Fr = "fr",
+    Ja = "ja"
+}
+/**
+ * Provide light weight translation capability for AppFx.
+ *
+ * Consumers of the AppFx library should sync the {@link AppfxTranslateService.locale} with their app locale.
+ * Avoid using the service as a general purpose translate service as that
+ *
+ * @example <caption>Use the component providers to isolate its translations.</caption>
+ * @Component({
+ *     providers: [
+ *         TranslateService,
+ *         {
+ *             provide: appfxTranslations,
+ *             useValue: {
+ *                 [Locale.En]: {
+ *                     "hello-world": "Hello World!",
+ *                 },
+ *                 [Locale.De]: {
+ *                     "hello-world": "Hallo Welt!",
+ *                 },
+ *             },
+ *         },
+ *         {
+ *             provide: appfxMissingTranslation,
+ *             useValue: (translations: Translations, locale: Locale, key: string, args?: InterpolationParams) => {
+ *                 return \`<Missing translation for locale "\${locale}" with key "\${key}">\`;
+ *             },
+ *         },
+ *     ],
+ * })
+ * export class TranslateDemoComponent {}
+ */
+declare class AppfxTranslateService {
+    private readonly translations;
+    private readonly emptyTranslationKeyCallback;
+    private static readonly localeSubject;
+    readonly localeChanged$: Observable<AppfxLocale>;
+    constructor(translations: AppfxTranslations, emptyTranslationKeyCallback: EmptyTranslationCallback);
+    get locale(): AppfxLocale;
+    set locale(locale: AppfxLocale);
+    /**
+     * Translates the given key in the current {@link AppfxTranslateService.locale}
+     * @param key The translation key
+     * @param args Optional key-value pairs where the key is interpolated in the translation value
+     *             through placeholders using the moustache syntax. For example "{{ placeholder-key }}".
+     *             If there's a missing interpolation param it's replaced with an empty string.
+     *             If no interpolation params are passed then placeholders are treated as normal text.
+     *
+     * @example <caption>Translation with params</caption>
+     * // Translations
+     * ...
+     * [Locale.En]: {
+     *     "hello": "Hello {{ name }}!",
+     * },
+     * ...
+     *
+     * const value = translateService.translate("hello", { name: "World" });
+     *
+     * console.log(value); // "Hello World!"
+     */
+    translate(key: string, args?: InterpolationParams): string;
+    /**
+     * Converts the {@link AppfxTranslateService.locale} to BCP 47 Language Tag to use with {@link Intl.DateTimeFormat}
+     */
+    localeAsBcp47(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppfxTranslateService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AppfxTranslateService>;
+}
+
+interface DateTimeFormatOptions {
+    dateTimeKind: DateTimeKind;
+    hourFormat?: HourFormat;
+}
+declare enum DateTimeKind {
+    Date = 0,
+    Time = 1,
+    DateTime = 2,
+    LongDateTime = 3
+}
+declare enum HourFormat {
+    Hour12 = "h12",
+    Hour24 = "h24"
+}
+declare class DateTimeService {
+    private readonly appfxTranslateService;
+    private readonly optionsMap;
+    private readonly defaultFormatOptions;
+    constructor(appfxTranslateService: AppfxTranslateService);
+    format(date?: Date, options?: DateTimeFormatOptions): string;
+    private transformOptions;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateTimeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DateTimeService>;
+}
+
+declare class DateTimePipe implements PipeTransform {
+    private readonly dateTimeService;
+    constructor(dateTimeService: DateTimeService);
+    transform(value?: Date, options?: DateTimeFormatOptions): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DateTimePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<DateTimePipe, "dateTime", false>;
+}
+
+declare class TranslatePipe implements PipeTransform {
+    private readonly appfxTranslateService;
+    constructor(appfxTranslateService: AppfxTranslateService);
+    transform(key: string, args?: Record<string, unknown>): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<TranslatePipe, "translate", false>;
+}
+
+declare class AppfxTranslateModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppfxTranslateModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AppfxTranslateModule, [typeof DateTimePipe, typeof TranslatePipe], [typeof i3.CommonModule], [typeof DateTimePipe, typeof TranslatePipe]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AppfxTranslateModule>;
+}
+
+export { AppfxLocale, AppfxTranslateModule, AppfxTranslateService, DateTimeKind, DateTimePipe, DateTimeService, HourFormat, AppfxLocale as Locale, AppfxTranslateModule as TranslateModule, TranslatePipe, AppfxTranslateService as TranslateService, appfxMissingTranslationToken, appfxTranslationsToken, defaultMissingTranslationHandler };
+export type { AppfxTranslations, DateTimeFormatOptions, EmptyTranslationCallback, InterpolationParams, AppfxTranslations as Translations };
+//# sourceMappingURL=hermes-ui-angular-addons-translate.d.ts.map

package/types/hermes-ui-angular-addons-translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-ui-angular-addons-translate.d.ts","sources":["../../../addons/translate/translate.service.ts","../../../addons/translate/date-time.service.ts","../../../addons/translate/date-time.pipe.ts","../../../addons/translate/translate.pipe.ts","../../../addons/translate/translate.module.ts"],"mappings":";;;;;AAUM,KAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM;AACtE,KAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM;AAC3C,KAAM,wBAAwB,kBACpB,iBAAiB,UACvB,WAAW,sBAEZ,mBAAmB;AAG5B;;AAEG;AACH,cAAa,sBAAsB,EAAA,cAAA,CAAA,QAAA,CAAA,MAAA,CAAA,WAAA,EAAA,QAAA,CAAA,MAAA;AAKnC;;AAEG;AACH,cAAa,4BAA4B,EAAA,cAAA,CAAA,wBAAA;AAKzC;;;;AAIG;AACH,iBAAgB,gCAAgC,eAChC,iBAAiB,UACvB,WAAW;AAMrB;;AAEG;AACH,aAAY,WAAW;AACrB;AACA;AACA;AACA;AACD;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;AACH,cACa,qBAAqB;;;AAChC;AAEA,6BAAyB,UAAU,CAAC,WAAW;AAGI,8BAAc,iBAAiB,+BAElC,wBAAwB;kBAG1D,WAAW;AAIzB,uBAAmB,WAAW;AAI9B;;;;;;;;;;;;;;;;;;;AAmBG;kCAC2B,mBAAmB;AAcjD;;AAEG;AACH;yCAxDW,qBAAqB;6CAArB,qBAAqB;AA2DjC;;UC5IgB,qBAAqB;kBACtB,YAAY;iBACb,UAAU;AACxB;AAED,aAAY,YAAY;AACtB;AACA;AACA;AACA;AACD;AAED,aAAY,UAAU;AACpB;AACA;AACD;AAcD,cACa,eAAe;;AAC1B;AAmBA;AAK6B,uCAAuB,qBAAqB;kBAE3D,IAAI,YAAY,qBAAqB;AAInD;yCA/BW,eAAe;6CAAf,eAAe;AA0C3B;;ACxED,cAKa,YAAa,YAAW,aAAa;;AACnB,iCAAiB,eAAe;sBAE3C,IAAI,YAAY,qBAAqB;yCAH5C,YAAY;uCAAZ,YAAY;AAMxB;;ACXD,cAKa,aAAc,YAAW,aAAa;;AACpB,uCAAuB,qBAAqB;AAEzE,kCAA8B,MAAM;yCAHzB,aAAa;uCAAb,aAAa;AAMzB;;ACPD,cAMa,oBAAoB;yCAApB,oBAAoB;0CAApB,oBAAoB,UAAAA,YAAA,SAAAC,aAAA,WAAA,EAAA,CAAA,YAAA,WAAAD,YAAA,SAAAC,aAAA;0CAApB,oBAAoB;AAAG;;","names":["i1.DateTimePipe","i2.TranslatePipe"]}