@filip.mazev/blocks 1.4.3 → 1.4.5

package/schematics/ng-add/index.js

@@ -50,7 +50,10 @@ function injectStyles(tree, context, options) {
         context.logger.warn('Could not locate a global .scss or .sass file. Please configure the Blocks theme manually.');
         return;
     }
-    const content = tree.read(targetStylePath).toString('utf-8');
+    const targetStyle = tree.read(targetStylePath);
+    if (!targetStyle)
+        return;
+    const content = targetStyle.toString('utf-8');
     // Existing themes still receive the effects stylesheet above.
     if (content.includes('@filip.mazev/blocks')) {
         context.logger.info('Blocks SCSS configuration already exists. Skipping style injection.');

package/types/filip.mazev-blocks-core.d.ts

@@ -39,6 +39,7 @@ export declare class DeviceTypeService {
   isPortraitOrientation(): boolean;
   getDeviceState(): IDeviceState;
   private get userAgent();
+  private toDeviceOrientation;
   private get isDesktopDevice();
   private isMobileDevice;
   private isTabletDevice;
@@ -129,9 +130,8 @@ export type DefaultValidatorKey = 'required' | 'minlength' | 'maxlength' | 'emai
 export type ValidatorKey = DefaultValidatorKey | keyof BxCustomValidators;
 /** Application-wide material preferences, inherited by components and overlays. */
 export interface BxAppearanceConfig {
-  material: 'glass' | 'frosted' | 'solid';
-  blur: number;
-  tint: number;
+  /** 0 is lightly blurred and nearly clear; 1 is richly tinted, retaining translucency. */
+  glassiness: number;
   quality: 'auto' | 'baseline' | 'enhanced';
   reducedTransparency: boolean;
 }
@@ -146,7 +146,6 @@ export declare class ThemingService implements OnDestroy {
   private readonly document;
   private readonly a11y;
   private readonly _appearance;
-  /** Application-wide material settings, including overlays. */
   readonly appearance: import("@angular/core").Signal<BxAppearanceConfig>;
   readonly palettes: readonly {
     id: BxThemeId;

package/types/filip.mazev-blocks-effects-runtime.d.ts

@@ -1,7 +1,7 @@
-type GlassMaterial = 'glass' | 'frosted' | 'solid';
 type GlassQuality = 'auto' | 'baseline' | 'enhanced';
 interface SurfaceOptions {
-  material?: GlassMaterial;
+  /** 0–1 glassiness; omitted values inherit the application's balanced default. */
+  glassiness?: number;
   /** Override automatic action/control detection for interaction lighting and press deformation. */
   interactive?: boolean;
   /** Override the default theme accent/error color emitted on interaction or an active ARIA state. */
@@ -10,10 +10,6 @@ interface SurfaceOptions {
   focusEmission?: string;
   reducedMotion?: boolean;
   reducedTransparency?: boolean;
-  /** Backdrop blur in CSS pixels, clamped to 0–40. */
-  blur?: number;
-  /** Tint opacity, clamped to 0–1. */
-  tint?: number;
 }
 interface AppearanceConfiguration extends Omit<SurfaceOptions, 'interactive' | 'emission' | 'focusEmission'> {
   quality?: GlassQuality;
@@ -74,6 +70,8 @@ interface GlassReflector {
   depth?: number;
 }
 interface GlassSceneOptions {
+  /** Reuse receiver measurements for frequent light-only updates. refresh() still invalidates them. */
+  reuseGeometry?: boolean;
   /** At most four lights and four reflectors are evaluated per scene. */
   lights?: readonly GlassLight[];
   reflectors?: readonly GlassReflector[];
@@ -95,6 +93,8 @@ interface LightContribution {
   color: string;
   strength: number;
   edgeStrength: number;
+  ambient?: boolean;
+  spread?: number;
 }
 interface Lighting {
   x: number;
@@ -112,8 +112,10 @@ interface Lighting {
 export declare function observeGlassLighting(element: HTMLElement, light: (value: Lighting) => void, hitTarget?: HTMLElement): () => void;
 /** Invalidate a receiver after an application changes its geometry. */
 export declare function refreshGlassLighting(element: HTMLElement): void;
-/** Lighting is an explicit spatial model; this does not capture or rasterize arbitrary page content. */
+/** Light fields are explicit; surfaces also sample nearby visual sources for ambient edge color. */
 export declare function mountGlassScene(root: HTMLElement, options?: GlassSceneOptions): GlassScene;
+/** Let a passive overlay receive light from its trigger's context. Register before mounting its surfaces. */
+export declare function inheritGlassLighting(overlay: HTMLElement, origin: HTMLElement): () => void;
 /** Fade a positioned overlay without changing the geometry of its content. */
 export declare function createGlassTransition(origin: HTMLElement, target: HTMLElement, options?: GlassTransitionOptions): GlassTransition;
 /** @deprecated Use createGlassTransition. */
@@ -136,4 +138,4 @@ export declare class Spring {
   step(deltaSeconds: number): boolean;
   snap(value: number): void;
 }
-export type { AppearanceConfiguration, AppearanceConfigurationController, GlassLight, Lighting as GlassLighting, GlassMaterial, GlassQuality, GlassReflector, GlassScene, GlassSceneOptions, GlassSurface, GlassTransition, GlassTransitionOptions, LiquidTransition, LiquidTransitionOptions, MotionResult, SpringOptions, SurfaceOptions };
+export type { AppearanceConfiguration, AppearanceConfigurationController, GlassLight, Lighting as GlassLighting, GlassQuality, GlassReflector, GlassScene, GlassSceneOptions, GlassSurface, GlassTransition, GlassTransitionOptions, LiquidTransition, LiquidTransitionOptions, MotionResult, SpringOptions, SurfaceOptions };

package/types/filip.mazev-blocks-effects.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from "@angular/core";
 import { AfterViewInit } from "@angular/core";
-import { GlassLight, GlassMaterial, GlassMaterial as GlassMaterial$1, SurfaceOptions, SurfaceOptions as SurfaceOptions$1 } from "@filip.mazev/blocks/effects/runtime";
+import { GlassLight, SurfaceOptions, SurfaceOptions as SurfaceOptions$1 } from "@filip.mazev/blocks/effects/runtime";
 /** Adds a decorative material without replacing native controls or their content. */
 export declare class BxSurfaceDirective implements AfterViewInit {
   private readonly element;
@@ -8,10 +8,8 @@ export declare class BxSurfaceDirective implements AfterViewInit {
   private readonly a11y;
   private readonly zone;
   private readonly isBrowser;
-  readonly bxSurface: import("@angular/core").InputSignalWithTransform<GlassMaterial$1 | undefined, "" | GlassMaterial$1 | undefined>;
   readonly bxSurfaceInteractive: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
-  readonly bxSurfaceBlur: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
-  readonly bxSurfaceTint: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
+  readonly bxSurfaceGlassiness: import("@angular/core").InputSignalWithTransform<number | undefined, unknown>;
   readonly bxSurfaceEmission: import("@angular/core").InputSignal<string | undefined>;
   readonly bxSurfaceFocusEmission: import("@angular/core").InputSignal<string | undefined>;
   readonly bxReducedTransparency: import("@angular/core").InputSignalWithTransform<boolean | undefined, unknown>;
@@ -21,23 +19,13 @@ export declare class BxSurfaceDirective implements AfterViewInit {
   private options;
   static ɵfac: i0.ɵɵFactoryDeclaration<BxSurfaceDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<BxSurfaceDirective, "[bxSurface]", ["bxSurface"], {
-    "bxSurface": {
-      "alias": "bxSurface";
-      "required": false;
-      "isSignal": true;
-    };
     "bxSurfaceInteractive": {
       "alias": "bxSurfaceInteractive";
       "required": false;
       "isSignal": true;
     };
-    "bxSurfaceBlur": {
-      "alias": "bxSurfaceBlur";
-      "required": false;
-      "isSignal": true;
-    };
-    "bxSurfaceTint": {
-      "alias": "bxSurfaceTint";
+    "bxSurfaceGlassiness": {
+      "alias": "bxSurfaceGlassiness";
       "required": false;
       "isSignal": true;
     };
@@ -72,4 +60,4 @@ export declare class BxGlassLightingService {
   static ɵfac: i0.ɵɵFactoryDeclaration<BxGlassLightingService, never>;
   static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-export type { GlassMaterial, SurfaceOptions };
+export type { SurfaceOptions };

package/types/filip.mazev-blocks-forms.d.ts

@@ -119,10 +119,12 @@ export declare class FormField {
     };
   }, {}, ["projectedError"], ["*", "bx-error"], true, never>;
 }
-export declare class InputField extends BxBaseControl<any> {
+export declare class InputField extends BxBaseControl<string | number | null> {
   private readonly i18n;
   protected readonly inputId: import("@angular/core").Signal<string>;
   protected readonly isFocused: import("@angular/core").WritableSignal<boolean>;
+  protected readonly isSpinDownDisabled: import("@angular/core").Signal<boolean>;
+  protected readonly isSpinUpDisabled: import("@angular/core").Signal<boolean>;
   protected readonly isFloating: import("@angular/core").Signal<boolean>;
   protected readonly resolvedPlaceholder: import("@angular/core").Signal<string>;
   protected readonly resolvedLabel: import("@angular/core").Signal<string>;
@@ -130,9 +132,9 @@ export declare class InputField extends BxBaseControl<any> {
   readonly min: import("@angular/core").InputSignal<number | undefined>;
   readonly max: import("@angular/core").InputSignal<number | undefined>;
   readonly step: import("@angular/core").InputSignal<number>;
-  constructor();
   private spinTimeout?;
   private spinInterval?;
+  constructor();
   startSpin(direction: number, event: MouseEvent | TouchEvent): void;
   stopSpin(): void;
   protected onInput(event: Event): void;
@@ -163,13 +165,13 @@ export declare class InputField extends BxBaseControl<any> {
     };
   }, {}, never, never, true, never>;
 }
-export declare class Radio extends BxBaseControl<any> {
+export declare class Radio extends BxBaseControl<unknown> {
   private readonly registry;
   private readonly element;
   private readonly i18n;
   protected readonly inputId: import("@angular/core").Signal<string>;
   protected readonly resolvedLabel: import("@angular/core").Signal<string | undefined>;
-  readonly value: import("@angular/core").InputSignal<any>;
+  readonly value: import("@angular/core").InputSignal<unknown>;
   readonly name: import("@angular/core").InputSignal<string>;
   protected showTooltip: boolean;
   constructor();
@@ -238,20 +240,20 @@ export declare class Select<T> extends BxBaseControl<T> implements OnInit, OnDes
     icon?: import("@filip.mazev/blocks/icons").IconName;
   }[]>;
   protected readonly selectedOptionLabel: import("@angular/core").Signal<string>;
+  protected readonly resolvedSearchPlaceholder: import("@angular/core").Signal<string>;
+  protected readonly resolvedEmptyMessage: import("@angular/core").Signal<string>;
   readonly options: import("@angular/core").InputSignal<BxSelectOption<T>[]>;
   readonly isSearchable: import("@angular/core").InputSignal<boolean>;
   readonly externalFiltering: import("@angular/core").InputSignal<boolean>;
+  readonly searchPlaceholder: import("@angular/core").InputSignal<ResolvableText>;
+  readonly emptyMessage: import("@angular/core").InputSignal<ResolvableText>;
+  readonly search: import("@angular/core").OutputEmitterRef<string>;
+  readonly isOpen: import("@angular/core").WritableSignal<boolean>;
   private transition?;
   private disconnectTheme?;
   private transitionRevision;
-  protected readonly resolvedSearchPlaceholder: import("@angular/core").Signal<string>;
   private focusOnOpen;
-  protected readonly resolvedEmptyMessage: import("@angular/core").Signal<string>;
   private connectedOverlay?;
-  readonly searchPlaceholder: import("@angular/core").InputSignal<ResolvableText>;
-  readonly emptyMessage: import("@angular/core").InputSignal<ResolvableText>;
-  readonly search: import("@angular/core").OutputEmitterRef<string>;
-  readonly isOpen: import("@angular/core").WritableSignal<boolean>;
   private searchInputRef?;
   private originRef?;
   private searchSubject;
@@ -313,7 +315,7 @@ export declare class SlideToggle extends BxBaseControl<boolean> {
 }
 export declare class BxError {
   static ɵfac: i0.ɵɵFactoryDeclaration<BxError, never>;
-  static ɵdir: i0.ɵɵDirectiveDeclaration<BxError, "bx-error", never, {}, {}, never, never, true, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BxError, "bx-error", never, {}, {}, never, ["*"], true, never>;
 }
 /** Glass styling for a native range, including reactive forms and programmatic values. */
 export declare class SliderDirective {

package/types/filip.mazev-blocks-modal.d.ts

@@ -386,6 +386,7 @@ export declare class ModalBottomSheet<D = unknown, R = unknown> implements OnIni
   private globalResizeCleanup;
   ngOnInit(): void;
   ngOnDestroy(): void;
+  protected onDismissClick(event: MouseEvent): void;
   private startVerticalSwipeDetection;
   private stopVerticalSwipeDetection;
   private initBottomSheetModalParams;

package/types/filip.mazev-blocks-navigation.d.ts

@@ -34,11 +34,11 @@ export interface INavContext {
   snapshot?: ActivatedRouteSnapshot;
 }
 export type NavText = ResolvableText | ((ctx: INavContext) => ResolvableText);
-export interface INavMeta {
+export interface INavMeta<TSection extends string = string> {
   label?: NavText;
   breadcrumb?: NavText;
   icon?: IconData;
-  section?: string;
+  section?: TSection;
   menu?: boolean;
   hidden?: boolean;
   order?: number;
@@ -68,14 +68,29 @@ export interface INavigationSectionConfig {
   order?: number;
 }
 export interface INavigationConfig {
-  sections?: INavigationSectionConfig[];
+  sections?: readonly INavigationSectionConfig[];
   includeHiddenInBreadcrumbs?: boolean;
   sortItems?: (a: INavigationItem, b: INavigationItem) => number;
 }
+/** A UI section containing flat, visible menu entries. */
+export interface INavigationGroup {
+  id: string;
+  title: string;
+  items: INavigationItem[];
+}
 export interface IResolvedNavigation {
   current?: INavigationItem;
   breadcrumbs: IBreadcrumbItem[];
 }
+/** Declares UI sections and binds route metadata to their literal IDs. */
+export declare function defineNavigation<const TSections extends readonly INavigationSectionConfig[]>(config: Omit<INavigationConfig, 'sections'> & {
+  sections: TSections;
+}): {
+  config: Omit<INavigationConfig, "sections"> & {
+    sections: TSections;
+  };
+  withNav<T extends INavMeta<TSections[number]["id"]>>(route: Route, nav: Strict<T, INavMeta<TSections[number]["id"]>>): Route;
+};
 /**
  *
  * @param config
@@ -96,7 +111,7 @@ export declare function provideNavigation(config: INavigationConfig): {
  * The function returns a new `Route` object with the provided navigation metadata merged into the existing route data under the 'nav' property.
  * This allows you to easily associate navigation information with your routes, which can then be used by navigation components to generate menus, breadcrumbs, etc.
  */
-export declare function withNav<T>(route: Route, nav: Strict<T, INavMeta>): Route;
+export declare function withNav<T extends INavMeta>(route: Route, nav: Strict<T, INavMeta>): Route;
 export declare class NavigationService {
   private readonly router;
   private readonly config;
@@ -108,6 +123,7 @@ export declare class NavigationService {
   readonly routes: Signal<INavigationItem[]>;
   readonly baseRoute: Signal<string | undefined>;
   readonly menu: Signal<INavigationItem[]>;
+  readonly menuGroups: Signal<INavigationGroup[]>;
   navigateBack(): void;
   private extractRoutes;
   private resolveCurrent;