@bemedev/typings 1.1.3 → 1.1.4

package/README.md

@@ -40,6 +40,52 @@ expectTypeOf(result).toEqualTypeOf<{
 
 <br/>
 
+## Pre-processing Types with `pretype`
+
+The `pretype` function allows you to pre-process type definitions before
+transformation, enabling type context chaining and reusable type pipelines:
+
+```ts
+import { type, pretype } from '@bemedev/typings';
+
+const baseType = type(({ partial, record, primitiveObject }) =>
+  partial({
+    emitters: record({
+      next: primitiveObject.const,
+      error: primitiveObject.const,
+    }),
+    children: record(primitiveObject.map.const),
+  }),
+);
+
+const pretypedResult = pretype(baseType);
+
+// Access the pre-processed type context
+const finalType = pretypedResult({
+  emitters: {
+    data: { next: 'string', error: 'string' },
+  },
+  children: { eventMap: 'string' },
+});
+
+expectTypeOf(finalType.type).toEqualTypeOf<{
+  emitters?: { data: { next: string; error: string } };
+  children?: { eventMap: string };
+}>();
+
+// The pretype result includes the original type definition
+expectTypeOf(pretypedResult.pretype).toEqualTypeOf(baseType);
+```
+
+N.B. The `pretype` function is designed to work with the type definitions
+created using the `type` function, allowing you to create complex type
+transformations while maintaining access to the original type context for
+further processing or reuse. Also `pretype.pretype` is a getter to the
+original type definition, which can be useful for chaining or referencing
+the base type in multiple transformations.
+
+<br/>
+
 ## Available Helpers
 
 - `any`: Any type

package/lib/type.cjs

@@ -52,7 +52,10 @@ const type = (option) => {
 	else out = _transform(option);
 	return require_standard.standardize(out);
 };
-const pretype = (_) => require_utils_expandFn.expandFn(type, { type });
+const pretype = (pretype) => require_utils_expandFn.expandFn(type, {
+	type,
+	pretype: require_standard.standardize(pretype?.__type ?? "any")
+});
 //#endregion
 exports.pretype = pretype;
 exports.type = type;

package/lib/type.d.ts

@@ -25,6 +25,7 @@ export type Transform_F = <T extends ObjectT = ObjectT>(option?: ((helpers: Help
 type _PreTransform_F<U extends ObjectT> = <T extends SafePre<U> = SafePre<U>>(option?: ((helpers: Helpers) => T) | T) => inferSh<T>;
 export type PreTransform_F = <U extends ObjectT>(_?: inferSh<U>) => FnBasic<_PreTransform_F<U>, {
     type: _PreTransform_F<U>;
+    pretype: inferSh<U>;
 }>;
 export declare const type: Transform_F;
 export declare const pretype: PreTransform_F;

package/lib/type.js

@@ -51,6 +51,9 @@ const type = (option) => {
 	else out = _transform(option);
 	return standardize(out);
 };
-const pretype = (_) => expandFn(type, { type });
+const pretype = (pretype) => expandFn(type, {
+	type,
+	pretype: standardize(pretype?.__type ?? "any")
+});
 //#endregion
 export { pretype, type };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bemedev/typings",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Typings by variables",
   "author": {
     "email": "bri_lvi@icloud.com",