@sd-angular/core 19.0.44 → 19.0.45

package/services/date-time/src/date-time.service.d.ts

@@ -0,0 +1,54 @@
+import { type SdTimeZone } from '@sd-angular/core/configurations';
+import * as i0 from "@angular/core";
+/**
+ * Converts and parses model dates in the zone of `ISdCoreConfiguration.timeZone`.
+ *
+ * - An instant (`Z`/offset, `Date`, epoch) shows as the wall clock of the zone.
+ * - A zone-less or date-only string keeps its digits and is read as wall clock in the zone.
+ * - A carrier is a local `Date` whose fields are a wall clock (what Material pickers hold);
+ *   `toWallClock` / `fromWallClock` are the only crossings between carriers and model values.
+ *
+ * With `'local'` (the default) every method returns exactly what `DateUtilities` returns
+ * without options.
+ */
+export declare class SdDateTimeService {
+    #private;
+    /** The configured zone, resolved once from the root injector. */
+    readonly timeZone: SdTimeZone;
+    constructor();
+    /** Formats a model value; `''` when invalid. */
+    toFormat(value: unknown, format: string): string;
+    /** Parses a model value to an instant; `null` when invalid. */
+    parse(value: unknown): Date | null;
+    /** Parses text in `format` as wall clock in the zone; `null` when invalid. */
+    parseFrom(value: unknown, format: string): Date | null;
+    /** First instant of the value's calendar day. */
+    begin(value: unknown): Date | null;
+    /** Last millisecond of the value's calendar day. */
+    end(value: unknown): Date | null;
+    /** First instant of the next calendar day: the exclusive upper bound of a day filter. */
+    beginOfNextDay(value: unknown): Date | null;
+    /** Carrier of today 00:00 in the zone. */
+    today(): Date;
+    /** Carrier of the current wall clock in the zone. */
+    now(): Date;
+    /** Carrier of a model value's wall clock in the zone; `null` when invalid. */
+    toWallClock(value: unknown): Date | null;
+    /** Instant of a carrier's wall clock in the zone. */
+    fromWallClock(value: Date): Date;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SdDateTimeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SdDateTimeService>;
+}
+/**
+ * @internal `SdDateTimeService` with `'local'`, for pure helpers that run without an injector (public
+ * helpers called directly by consumers, unit tests). Every method equals the service in local mode.
+ */
+export declare const ɵSD_LOCAL_DATE_TIME: Pick<SdDateTimeService, 'timeZone' | 'toFormat' | 'parse' | 'begin' | 'end' | 'beginOfNextDay'>;
+/**
+ * @internal The service inside an injection context, `null` outside one.
+ *
+ * Pipes call it from a field initializer: created by DI or a template they follow the zone, while
+ * `new SdTimeDifferentPipe()` outside an injection context keeps the local behavior. Only the
+ * "no injection context" error (NG0203) is swallowed; an invalid zone still throws.
+ */
+export declare function ɵsdInjectDateTime(): SdDateTimeService | null;

package/services/date-time/src/public-api.d.ts

@@ -0,0 +1 @@
+export * from './date-time.service';

package/services/index.d.ts

@@ -6,3 +6,4 @@ export * from '@sd-angular/core/services/api';
 export * from '@sd-angular/core/services/loading';
 export * from '@sd-angular/core/services/excel';
 export * from '@sd-angular/core/services/docx';
+export * from '@sd-angular/core/services/date-time';

package/utilities/extensions/src/string.extension.d.ts

@@ -37,6 +37,7 @@ export declare const StringUtilities: {
     REGEX_BASE64: string;
     changeAliasLowerCase: (alias: any) => string;
     aliasIncludes: (alias: any, searchText: any) => boolean;
+    mask: <T extends string | null | undefined>(value: T, options?: import("@sdcorejs/utils/fns").StringMaskOptions) => T extends string ? string : T;
     format: (template: string, ...arr: any[]) => string;
     templateToDisplay: (template: string, entity: Record<string, any>, options?: import("@sdcorejs/utils/fns").TemplatePathOptions) => string;
     parseExpression: (template: string, entity: Record<string, any>, options?: import("@sdcorejs/utils/fns").TemplatePathOptions) => unknown;

package/utilities/models/src/icon.model.d.ts

@@ -1,2 +1,4 @@
 export type MaterialIconFontSet = 'material-icons' | 'material-icons-outlined' | 'material-icons-round' | 'material-icons-sharp';
 export declare const DefaultMaterialIconFontSet: MaterialIconFontSet;
+/** Background of a decorative icon tile: rounded square (8px), circle, or none (no background, same size). */
+export type SdIconShape = 'square' | 'circle' | 'none';