@dereekb/util 12.4.5 → 12.5.1

package/src/lib/string/factory.d.ts

@@ -1,4 +1,6 @@
-import { type Factory, type FactoryWithRequiredInput } from '../getter';
+import { FactoryWithInput, type Factory, type FactoryWithRequiredInput } from '../getter';
+import { Maybe } from '../value';
+import { TransformStringFunctionConfig } from './transform';
 export type StringFactory<K extends string = string> = Factory<K>;
 export type ToStringFunction<T, K extends string = string> = FactoryWithRequiredInput<K, T>;
 /**
@@ -9,3 +11,37 @@ export type ToStringFunction<T, K extends string = string> = FactoryWithRequired
  * @returns
  */
 export declare function stringFactoryFromFactory<T, K extends string = string>(factory: Factory<T>, toStringFunction: ToStringFunction<T, K>): StringFactory<K>;
+/**
+ * A factory that returns a string based on the input date.
+ */
+export type StringFromDateFactory = FactoryWithInput<string, Maybe<Date>>;
+export interface StringFromDateConfig {
+    /**
+     * The number of digits to return from the end of the generated string.
+     *
+     * Is ignored if transformStringConfig.slice is set, or the value is 0.
+     */
+    readonly takeFromEnd?: number;
+    /**
+     * Optional/additional transformations to apply to the string.
+     */
+    readonly transformStringConfig?: Maybe<TransformStringFunctionConfig>;
+    /**
+     * The factory function to generate the initial string from the input date.
+     */
+    readonly dateToString: FactoryWithRequiredInput<string, Date>;
+}
+/**
+ * Creates a factory that returns a string based on the input date.
+ 
+ * @param config Configuration for the factory.
+ * @returns A factory that returns a string based on the input date.
+ */
+export declare function stringFromDateFactory(config: StringFromDateConfig): StringFromDateFactory;
+/**
+ * Creates a factory that returns a string based on the Unix timestamp of the input date.
+ *
+ * @param digitsFromEnd The number of digits to return from the end of the generated string. Defaults to 7.
+ * @returns A StringFromDateFactory.
+ */
+export declare function stringFromTimeFactory(digitsFromEnd?: number): StringFromDateFactory;

package/src/lib/string/mimetype.d.ts

@@ -1,12 +1,42 @@
+import { Maybe } from '../value/maybe.type';
 /**
  * A simple mime type string with just the type/subtype and no parameters.
  *
  * I.E. "application/json"
  */
 export type MimeTypeWithoutParameters = string;
+/**
+ * The mimetype wildcard.
+ */
+export type MimeTypeWildcard = '*';
+/**
+ * A mime type with a wildcard subtype. Has a star as the subtype.
+ *
+ * I.E. "application/*"
+ */
+export type MimeTypeWithSubtypeWildcardWithoutParameters = string;
 /**
  * A mime type string that may contain additional parameters.
  *
  * I.E. "text/plain", "application/json; charset=utf-8"
  */
 export type ContentTypeMimeType = string;
+/**
+ * Input for mimetypeForImageType().
+ *
+ * This is a non-exhaustive list of common image types.
+ */
+export type MimeTypeForImageTypeInputType = 'jpeg' | 'jpg' | 'png' | 'webp' | 'gif' | 'svg' | 'raw' | 'heif' | 'tiff';
+export declare const JPEG_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const PNG_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const WEBP_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const GIF_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const HEIF_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const TIFF_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const SVG_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const RAW_MIME_TYPE: MimeTypeWithoutParameters;
+/**
+ * Returns the mimetype for the given image type, or undefined if the type is not known.
+ */
+export declare function mimetypeForImageType(imageType: MimeTypeForImageTypeInputType): MimeTypeWithoutParameters;
+export declare function mimetypeForImageType(imageType: MimeTypeForImageTypeInputType | string): Maybe<MimeTypeWithoutParameters>;

package/src/lib/string/transform.d.ts

@@ -40,6 +40,10 @@ export type TransformStringFunctionConfig<S extends string = string> = {
      * This is ignored if a custom `transform` function is provided and takes precedence over `toLowercase` if both are true.
      */
     readonly toUppercase?: boolean;
+    /**
+     * Slices the string based on the configuration.
+     */
+    readonly slice?: SliceStringFunctionConfig;
     /**
      * An optional custom function to transform the string.
      * If provided, `toLowercase` and `toUppercase` are ignored. Trimming (if `trim` is true) occurs before this custom transform.
@@ -82,6 +86,7 @@ export declare function transformStringFunctionConfig<S extends string = string>
  * Creates a string transformation function based on the provided configuration.
  * The resulting function will apply transformations in a specific order:
  * 1. Trimming (if `config.trim` is true).
+ * 2. Slicing (if `config.slice` is provided).
  * 2. Custom `config.transform` function (if provided).
  * 3. Uppercase conversion (if `config.toUppercase` is true and no `config.transform`).
  * 4. Lowercase conversion (if `config.toLowercase` is true and no `config.transform` or `config.toUppercase`).
@@ -131,3 +136,37 @@ export type PadStartFunction = TransformStringFunction;
  * @returns A function that pads the start of a string.
  */
 export declare function padStartFunction(minLength: number, padCharacter: string): PadStartFunction;
+/**
+ * Function that slices and concats parts of a string based on the configuration.
+ */
+export type SliceStringFunction = TransformStringFunction;
+/**
+ * Configuration for sliceStringFunction()
+ */
+export interface SliceStringFunctionConfig {
+    /**
+     * The number of characters to take from the start of the string.
+     *
+     * When both fromStart and fromEnd are specified, the first N characters are concatenated with the last M characters.
+     * If the total (fromStart + fromEnd) is greater than or equal to the string length, the entire string is returned.
+     *
+     * If undefined or 0, only takes from the end of the string. The absolute value of this number is used.
+     */
+    readonly fromStart?: number;
+    /**
+     * The number of characters to take from the end of the string.
+     *
+     * When both fromStart and fromEnd are specified, the first N characters are concatenated with the last M characters.
+     * If the total (fromStart + fromEnd) is greater than or equal to the string length, the entire string is returned.
+     *
+     * If undefined or 0, only takes from the start of the string. The absolute value of this number is used.
+     */
+    readonly fromEnd?: number;
+}
+/**
+ * Creates a function that slices and concats parts of a string based on the configuration.
+ *
+ * @param config The configuration for the slice function.
+ * @returns A SliceStringFunction.
+ */
+export declare function sliceStringFunction(config: SliceStringFunctionConfig): SliceStringFunction;

package/test/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [12.5.1](https://github.com/dereekb/dbx-components/compare/v12.5.0-dev...v12.5.1) (2025-10-14)
+
+
+
+# [12.5.0](https://github.com/dereekb/dbx-components/compare/v12.4.5-dev...v12.5.0) (2025-10-13)
+
+
+
 ## [12.4.5](https://github.com/dereekb/dbx-components/compare/v12.4.4-dev...v12.4.5) (2025-09-14)
 
 

package/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/test",
-  "version": "12.4.5",
+  "version": "12.5.1",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*"