@duplojs/utils 1.4.52 → 1.4.54

package/dist/clean/constraint/base.cjs

@@ -3,7 +3,9 @@
 var kind = require('../kind.cjs');
 var kind$1 = require('../../common/kind.cjs');
 var coalescing = require('../../array/coalescing.cjs');
+var pipe = require('../../common/pipe.cjs');
 var errorKindNamespace = require('../../common/errorKindNamespace.cjs');
+var override = require('../../common/override.cjs');
 var is = require('../../either/left/is.cjs');
 var unwrap = require('../../common/unwrap.cjs');
 var create = require('../../either/left/create.cjs');
@@ -62,7 +64,7 @@ function createConstraint(name, primitiveHandler, checker) {
         }
         return false;
     }
-    return constraintHandlerKind.setTo({
+    return pipe.pipe({
         name,
         primitiveHandler,
         checkers,
@@ -71,8 +73,9 @@ function createConstraint(name, primitiveHandler, checker) {
         createWithUnknown: create$2,
         createWithUnknownOrThrow: createOrThrow,
         is: is$1,
-    });
+    }, constraintHandlerKind.setTo, createConstraint.overrideHandler.apply);
 }
+createConstraint.overrideHandler = override.createOverride("@duplojs/utils/clean/constraint");
 
 exports.CreateConstrainedTypeError = CreateConstrainedTypeError;
 exports.constrainedTypeKind = constrainedTypeKind;

package/dist/clean/constraint/base.d.ts

@@ -138,5 +138,8 @@ export declare function createConstraint<GenericName extends string, GenericPrim
     DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, GenericPrimitiveValue>,
     ...DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, GenericPrimitiveValue>[]
 ]) = never>(name: GenericName, primitiveHandler: PrimitiveHandler<GenericPrimitiveValue>, checker: GenericChecker): ConstraintHandler<GenericName, GenericPrimitiveValue, DArray.ArrayCoalescing<GenericChecker>>;
+export declare namespace createConstraint {
+    var overrideHandler: import("../..").OverrideHandler<ConstraintHandler<string, EligiblePrimitive, readonly DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, unknown>[]>>;
+}
 export type GetConstraint<GenericConstrainHandler extends ConstraintHandler, GenericValue extends DDataParser.InputChecker<GenericConstrainHandler["checkers"][number]> = DDataParser.InputChecker<GenericConstrainHandler["checkers"][number]>> = Extract<ConstrainedType<GenericConstrainHandler["name"], GenericValue>, any>;
 export {};

package/dist/clean/constraint/base.mjs

@@ -1,7 +1,9 @@
 import { createCleanKind } from '../kind.mjs';
 import { kindHeritage } from '../../common/kind.mjs';
 import { coalescing } from '../../array/coalescing.mjs';
+import { pipe } from '../../common/pipe.mjs';
 import { createErrorKind } from '../../common/errorKindNamespace.mjs';
+import { createOverride } from '../../common/override.mjs';
 import { isLeft } from '../../either/left/is.mjs';
 import { unwrap } from '../../common/unwrap.mjs';
 import { left } from '../../either/left/create.mjs';
@@ -60,7 +62,7 @@ function createConstraint(name, primitiveHandler, checker) {
         }
         return false;
     }
-    return constraintHandlerKind.setTo({
+    return pipe({
         name,
         primitiveHandler,
         checkers,
@@ -69,7 +71,8 @@ function createConstraint(name, primitiveHandler, checker) {
         createWithUnknown: create,
         createWithUnknownOrThrow: createOrThrow,
         is,
-    });
+    }, constraintHandlerKind.setTo, createConstraint.overrideHandler.apply);
 }
+createConstraint.overrideHandler = createOverride("@duplojs/utils/clean/constraint");
 
 export { CreateConstrainedTypeError, constrainedTypeKind, constraintHandlerKind, createConstraint };

package/dist/clean/constraint/defaultConstraint/number.cjs

@@ -30,9 +30,17 @@ function NumberMin(value) {
 function NumberMax(value) {
     return base.createConstraint(`number-max-${value}`, base$1.Number, max.checkerNumberMax(value));
 }
+/**
+ * {@include clean/PositiveInt/index.md}
+ */
+const PositiveInt = base.createConstraint("positive-int", base$1.Number, [
+    int.checkerInt(),
+    min.checkerNumberMin(1),
+]);
 
 exports.Int = Int;
 exports.Negative = Negative;
 exports.NumberMax = NumberMax;
 exports.NumberMin = NumberMin;
 exports.Positive = Positive;
+exports.PositiveInt = PositiveInt;

package/dist/clean/constraint/defaultConstraint/number.d.ts

@@ -148,3 +148,32 @@ export type NumberMin<GenericValue extends number> = ReturnType<typeof NumberMin
  */
 export declare function NumberMax<GenericValue extends number>(value: GenericValue & OnlyLiteralNumber<GenericValue>): import("..").ConstraintHandler<`number-max-${GenericValue & OnlyLiteralNumber<GenericValue>}`, number, readonly [DDataParser.DataParserCheckerNumberMax]>;
 export type NumberMax<GenericValue extends number> = ReturnType<typeof NumberMax<GenericValue>>;
+/**
+ * Constraint handler that validates strictly positive integers (>= 1).
+ * 
+ * **Supported call styles:**
+ * - Classic: `PositiveInt.create(value)` -> returns Either
+ * 
+ * Use it as a reusable rule to validate inputs and to constrain NewTypes to positive integer numbers.
+ * 
+ * ```ts
+ * const result = C.PositiveInt.create(4);
+ * 
+ * if (E.isRight(result)) {
+ * 	// result: E.Right<"createConstrainedType", C.ConstrainedType<"positive-int", 4>>
+ * }
+ * 
+ * const value = C.PositiveInt.createOrThrow(10);
+ * // value: C.ConstrainedType<"positive-int", 10>
+ * 
+ * C.PositiveInt.is(value); // type guard
+ * 
+ * ```
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/clean/constraints
+ * 
+ * @namespace C
+ * 
+ */
+export declare const PositiveInt: import("..").ConstraintHandler<"positive-int", number, readonly [DDataParser.DataParserCheckerInt, DDataParser.DataParserCheckerNumberMin]>;
+export type PositiveInt = GetConstraint<typeof PositiveInt>;

package/dist/clean/constraint/defaultConstraint/number.mjs

@@ -28,5 +28,12 @@ function NumberMin(value) {
 function NumberMax(value) {
     return createConstraint(`number-max-${value}`, Number, checkerNumberMax(value));
 }
+/**
+ * {@include clean/PositiveInt/index.md}
+ */
+const PositiveInt = createConstraint("positive-int", Number, [
+    checkerInt(),
+    checkerNumberMin(1),
+]);
 
-export { Int, Negative, NumberMax, NumberMin, Positive };
+export { Int, Negative, NumberMax, NumberMin, Positive, PositiveInt };

package/dist/clean/constraint/set.cjs

@@ -9,12 +9,13 @@ var pipe = require('../../common/pipe.cjs');
 var map = require('../../array/map.cjs');
 var entry = require('../../object/entry.cjs');
 var errorKindNamespace = require('../../common/errorKindNamespace.cjs');
+var fromEntries = require('../../object/fromEntries.cjs');
+var override = require('../../common/override.cjs');
 var is = require('../../either/left/is.cjs');
 var unwrap = require('../../common/unwrap.cjs');
 var create = require('../../either/left/create.cjs');
 var create$1 = require('../../either/right/create.cjs');
 var wrapValue = require('../../common/wrapValue.cjs');
-var fromEntries = require('../../object/fromEntries.cjs');
 
 const constraintsSetHandlerKind = kind.createCleanKind("constraints-set-handler");
 class CreateConstraintsSetError extends kind$1.kindHeritage("create-constraint-set-error", errorKindNamespace.createErrorKind("create-constraint-set-error"), Error) {
@@ -76,7 +77,7 @@ function createConstraintsSet(primitiveHandler, constraint) {
         }
         return true;
     }
-    return constraintsSetHandlerKind.setTo({
+    return pipe.pipe({
         primitiveHandler,
         constrains: constraints,
         getConstraint,
@@ -85,8 +86,9 @@ function createConstraintsSet(primitiveHandler, constraint) {
         createWithUnknown: create$2,
         createWithUnknownOrThrow: createOrThrow,
         is: is$1,
-    });
+    }, constraintsSetHandlerKind.setTo, createConstraintsSet.overrideHandler.apply);
 }
+createConstraintsSet.overrideHandler = override.createOverride("@duplojs/utils/clean/constraints-set");
 
 exports.CreateConstraintsSetError = CreateConstraintsSetError;
 exports.constraintsSetHandlerKind = constraintsSetHandlerKind;

package/dist/clean/constraint/set.d.ts

@@ -140,5 +140,8 @@ export declare function createConstraintsSet<GenericPrimitiveValue extends Eligi
     ConstraintHandler<string, EligiblePrimitive, readonly DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, GenericPrimitiveValue>[]>,
     ...ConstraintHandler<string, EligiblePrimitive, readonly DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, GenericPrimitiveValue>[]>[]
 ]) = never>(primitiveHandler: PrimitiveHandler<GenericPrimitiveValue>, constraint: GenericConstrainHandler): ConstraintsSetHandler<GenericPrimitiveValue, DArray.ArrayCoalescing<GenericConstrainHandler>>;
-export type GetConstraints<GenericHandler extends ConstraintsSetHandler<string, readonly any[]>> = Extract<GenericHandler extends any ? UnionToIntersection<GenericHandler["constrains"][number] extends infer InferredConstraint ? InferredConstraint extends ConstraintHandler ? GetConstraint<InferredConstraint> : never : never> : never, any>;
+export declare namespace createConstraintsSet {
+    var overrideHandler: import("../..").OverrideHandler<ConstraintsSetHandler<EligiblePrimitive, readonly []>>;
+}
+export type GetConstraints<GenericHandler extends ConstraintsSetHandler<EligiblePrimitive, readonly any[]>> = Extract<GenericHandler extends any ? UnionToIntersection<GenericHandler["constrains"][number] extends infer InferredConstraint ? InferredConstraint extends ConstraintHandler ? GetConstraint<InferredConstraint> : never : never> : never, any>;
 export {};

package/dist/clean/constraint/set.mjs

@@ -7,12 +7,13 @@ import { pipe } from '../../common/pipe.mjs';
 import { map } from '../../array/map.mjs';
 import { entry } from '../../object/entry.mjs';
 import { createErrorKind } from '../../common/errorKindNamespace.mjs';
+import { fromEntries } from '../../object/fromEntries.mjs';
+import { createOverride } from '../../common/override.mjs';
 import { isLeft } from '../../either/left/is.mjs';
 import { unwrap } from '../../common/unwrap.mjs';
 import { left } from '../../either/left/create.mjs';
 import { right } from '../../either/right/create.mjs';
 import { wrapValue } from '../../common/wrapValue.mjs';
-import { fromEntries } from '../../object/fromEntries.mjs';
 
 const constraintsSetHandlerKind = createCleanKind("constraints-set-handler");
 class CreateConstraintsSetError extends kindHeritage("create-constraint-set-error", createErrorKind("create-constraint-set-error"), Error) {
@@ -74,7 +75,7 @@ function createConstraintsSet(primitiveHandler, constraint) {
         }
         return true;
     }
-    return constraintsSetHandlerKind.setTo({
+    return pipe({
         primitiveHandler,
         constrains: constraints,
         getConstraint,
@@ -83,7 +84,8 @@ function createConstraintsSet(primitiveHandler, constraint) {
         createWithUnknown: create,
         createWithUnknownOrThrow: createOrThrow,
         is,
-    });
+    }, constraintsSetHandlerKind.setTo, createConstraintsSet.overrideHandler.apply);
 }
+createConstraintsSet.overrideHandler = createOverride("@duplojs/utils/clean/constraints-set");
 
 export { CreateConstraintsSetError, constraintsSetHandlerKind, createConstraintsSet };

package/dist/clean/entity.cjs

@@ -31,11 +31,12 @@ var otherwise = require('../pattern/otherwise.cjs');
 var justReturn = require('../common/justReturn.cjs');
 var union = require('../dataParser/parsers/union.cjs');
 var minElements = require('../array/minElements.cjs');
+var index$1 = require('../dataParser/parsers/object/index.cjs');
+var override = require('../common/override.cjs');
 var is = require('../either/left/is.cjs');
 var unwrap = require('../common/unwrap.cjs');
 var create = require('../either/left/create.cjs');
 var create$1 = require('../either/right/create.cjs');
-var index$1 = require('../dataParser/parsers/object/index.cjs');
 
 const entityKind = kind.createCleanKind("entity");
 const entityHandlerKind = kind.createCleanKind("entity-handler");
@@ -125,7 +126,7 @@ function createEntity(name, getPropertiesDefinition) {
         }
         return entityKind.setTo(updatedEntity, name);
     }
-    return entityHandlerKind.setTo({
+    return pipe.pipe({
         name,
         propertiesDefinition,
         mapDataParser,
@@ -134,8 +135,9 @@ function createEntity(name, getPropertiesDefinition) {
         mapOrThrow,
         is: is$1,
         update,
-    });
+    }, entityHandlerKind.setTo, createEntity.overrideHandler.apply);
 }
+createEntity.overrideHandler = override.createOverride("@duplojs/utils/clean/entity");
 
 exports.CreateEntityError = CreateEntityError;
 exports.createEntity = createEntity;

package/dist/clean/entity.d.ts

@@ -224,5 +224,8 @@ export interface PropertiesDefinitionParams {
  * 
  */
 export declare function createEntity<GenericName extends string, const GenericPropertiesDefinition extends EntityPropertiesDefinition>(name: GenericName, getPropertiesDefinition: (params: PropertiesDefinitionParams) => GenericPropertiesDefinition & DObject.ForbiddenKey<GenericPropertiesDefinition, "_entityName" | "_flags">): EntityHandler<GenericName, GenericPropertiesDefinition>;
+export declare namespace createEntity {
+    var overrideHandler: import("../common").OverrideHandler<EntityHandler<string, Readonly<Record<string, EntityPropertyDefinition>>>>;
+}
 export type GetEntity<GenericEntityHandler extends EntityHandler<string, any>> = Extract<ReturnType<GenericEntityHandler["new"]>, any>;
 export {};

package/dist/clean/entity.mjs

@@ -29,11 +29,12 @@ import { otherwise } from '../pattern/otherwise.mjs';
 import { justReturn } from '../common/justReturn.mjs';
 import { union } from '../dataParser/parsers/union.mjs';
 import { minElements } from '../array/minElements.mjs';
+import { object } from '../dataParser/parsers/object/index.mjs';
+import { createOverride } from '../common/override.mjs';
 import { isLeft } from '../either/left/is.mjs';
 import { unwrap } from '../common/unwrap.mjs';
 import { left } from '../either/left/create.mjs';
 import { right } from '../either/right/create.mjs';
-import { object } from '../dataParser/parsers/object/index.mjs';
 
 const entityKind = createCleanKind("entity");
 const entityHandlerKind = createCleanKind("entity-handler");
@@ -123,7 +124,7 @@ function createEntity(name, getPropertiesDefinition) {
         }
         return entityKind.setTo(updatedEntity, name);
     }
-    return entityHandlerKind.setTo({
+    return pipe({
         name,
         propertiesDefinition,
         mapDataParser,
@@ -132,7 +133,8 @@ function createEntity(name, getPropertiesDefinition) {
         mapOrThrow,
         is,
         update,
-    });
+    }, entityHandlerKind.setTo, createEntity.overrideHandler.apply);
 }
+createEntity.overrideHandler = createOverride("@duplojs/utils/clean/entity");
 
 export { CreateEntityError, createEntity, entityKind };

package/dist/clean/flag.cjs

@@ -1,6 +1,8 @@
 'use strict';
 
 var kind = require('./kind.cjs');
+var pipe = require('../common/pipe.cjs');
+var override = require('../common/override.cjs');
 
 const flagHandlerKind = kind.createCleanKind("flag-handler");
 const flagKind = kind.createCleanKind("flag");
@@ -8,7 +10,7 @@ const flagKind = kind.createCleanKind("flag");
  * {@include clean/createFlag/index.md}
  */
 function createFlag(name) {
-    return flagHandlerKind.setTo({
+    return pipe.pipe({
         name,
         append(entity, value) {
             const flagValue = flagKind.has(entity)
@@ -26,8 +28,9 @@ function createFlag(name) {
             return flagKind.has(entity)
                 && name in flagKind.getValue(entity);
         },
-    });
+    }, flagHandlerKind.setTo, createFlag.overrideHandler.apply);
 }
+createFlag.overrideHandler = override.createOverride("@duplojs/utils/clean/flag");
 
 exports.createFlag = createFlag;
 exports.flagKind = flagKind;

package/dist/clean/flag.d.ts

@@ -110,5 +110,8 @@ export declare function createFlag<GenericEntity extends Entity = never, Generic
     IsEqual<GenericEntity, never>,
     IsEqual<GenericName, never>
 ]> extends true ? never : NoInfer<GenericName>): FlagHandler<GenericEntity, GenericName, GenericValue>;
+export declare namespace createFlag {
+    var overrideHandler: import("../common").OverrideHandler<FlagHandler<Entity<string>, string, never>>;
+}
 export type GetFlag<GenericHandler extends FlagHandler<any, any, any>> = Extract<Flag<GenericHandler["name"], ReturnType<GenericHandler["getValue"]>>, any>;
 export {};

package/dist/clean/flag.mjs

@@ -1,4 +1,6 @@
 import { createCleanKind } from './kind.mjs';
+import { pipe } from '../common/pipe.mjs';
+import { createOverride } from '../common/override.mjs';
 
 const flagHandlerKind = createCleanKind("flag-handler");
 const flagKind = createCleanKind("flag");
@@ -6,7 +8,7 @@ const flagKind = createCleanKind("flag");
  * {@include clean/createFlag/index.md}
  */
 function createFlag(name) {
-    return flagHandlerKind.setTo({
+    return pipe({
         name,
         append(entity, value) {
             const flagValue = flagKind.has(entity)
@@ -24,7 +26,8 @@ function createFlag(name) {
             return flagKind.has(entity)
                 && name in flagKind.getValue(entity);
         },
-    });
+    }, flagHandlerKind.setTo, createFlag.overrideHandler.apply);
 }
+createFlag.overrideHandler = createOverride("@duplojs/utils/clean/flag");
 
 export { createFlag, flagKind };

package/dist/clean/index.cjs

@@ -7,6 +7,7 @@ var repository = require('./repository.cjs');
 var useCase = require('./useCase.cjs');
 var flag = require('./flag.cjs');
 var unwrapEntity = require('./unwrapEntity.cjs');
+var maybe = require('./maybe.cjs');
 var base = require('./constraint/base.cjs');
 var number = require('./constraint/defaultConstraint/number.cjs');
 var string = require('./constraint/defaultConstraint/string.cjs');
@@ -58,6 +59,8 @@ exports.useCaseInstances = useCase.useCaseInstances;
 exports.createFlag = flag.createFlag;
 exports.flagKind = flag.flagKind;
 exports.unwrapEntity = unwrapEntity.unwrapEntity;
+exports.none = maybe.none;
+exports.some = maybe.some;
 exports.CreateConstrainedTypeError = base.CreateConstrainedTypeError;
 exports.constrainedTypeKind = base.constrainedTypeKind;
 exports.constraintHandlerKind = base.constraintHandlerKind;
@@ -67,6 +70,7 @@ exports.Negative = number.Negative;
 exports.NumberMax = number.NumberMax;
 exports.NumberMin = number.NumberMin;
 exports.Positive = number.Positive;
+exports.PositiveInt = number.PositiveInt;
 exports.Email = string.Email;
 exports.StringMax = string.StringMax;
 exports.StringMin = string.StringMin;

package/dist/clean/index.d.ts

@@ -33,3 +33,4 @@ export * from "./repository";
 export * from "./useCase";
 export * from "./flag";
 export * from "./unwrapEntity";
+export * from "./maybe";

package/dist/clean/index.mjs

@@ -5,8 +5,9 @@ export { createRepository, repositoryHandlerKind } from './repository.mjs';
 export { createUseCase, useCaseHandlerKind, useCaseInstances } from './useCase.mjs';
 export { createFlag, flagKind } from './flag.mjs';
 export { unwrapEntity } from './unwrapEntity.mjs';
+export { none, some } from './maybe.mjs';
 export { CreateConstrainedTypeError, constrainedTypeKind, constraintHandlerKind, createConstraint } from './constraint/base.mjs';
-export { Int, Negative, NumberMax, NumberMin, Positive } from './constraint/defaultConstraint/number.mjs';
+export { Int, Negative, NumberMax, NumberMin, Positive, PositiveInt } from './constraint/defaultConstraint/number.mjs';
 export { Email, StringMax, StringMin, Url } from './constraint/defaultConstraint/string.mjs';
 export { CreateConstraintsSetError, constraintsSetHandlerKind, createConstraintsSet } from './constraint/set.mjs';
 export { BigInt, Boolean, CreatePrimitiveError, Date, Number, String, Time, primitiveHandlerKind } from './primitive/base.mjs';

package/dist/clean/maybe.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var entity = require('./entity.cjs');
+var create = require('../either/right/create.cjs');
+var create$1 = require('../either/left/create.cjs');
+
+/**
+ * {@include clean/some/index.md}
+ */
+function some(entity$1) {
+    return create.right(`some-${entity.entityKind.getValue(entity$1)}`, entity$1);
+}
+/**
+ * {@include clean/none/index.md}
+ */
+function none(entityName) {
+    return create$1.left(`none-${entityName}`, null);
+}
+
+exports.none = none;
+exports.some = some;

package/dist/clean/maybe.d.ts

@@ -0,0 +1,135 @@
+import * as DEither from "../either";
+import { type Entity, entityKind } from "./entity";
+import { type GetKindValue } from "../common";
+export interface Some<GenericEntity extends Entity = Entity> extends DEither.Right<`some-${GetKindValue<typeof entityKind, GenericEntity>}`, GenericEntity> {
+}
+export interface None<GenericEntityName extends string = string> extends DEither.Left<`none-${GenericEntityName}`, null> {
+}
+/**
+ * Union type that represents an optional entity in business flows.
+ * 
+ * **Supported usage style:**
+ * - Type contract: `Maybe<Entity>`
+ * 
+ * Use `Maybe` to define a business contract before implementation details. Then produce values with `some(entity)` when data exists, or `none(entityName)` when it does not.
+ * 
+ * ```ts
+ * const UserId = C.createNewType("userId", DPE.number());
+ * const User = C.createEntity("User", () => ({
+ * 	id: UserId,
+ * }));
+ * 
+ * type UserMaybe = C.Maybe<
+ * 	C.GetEntity<typeof User>
+ * >;
+ * 
+ * const availableUser = User.new({
+ * 	id: UserId.createOrThrow(1 as number),
+ * });
+ * 
+ * const foundUser: UserMaybe = C.some(availableUser);
+ * const missingUser: UserMaybe = C.none("User");
+ * 
+ * type checkFound = ExpectType<
+ * 	typeof foundUser,
+ * 	C.Some<typeof availableUser>,
+ * 	"strict"
+ * >;
+ * 
+ * type checkMissing = ExpectType<
+ * 	typeof missingUser,
+ * 	C.None<"User">,
+ * 	"strict"
+ * >;
+ * ```
+ * 
+ * @remarks
+ * `Maybe` helps keep use-case signatures explicit: a function can return a typed optional entity without exposing null/undefined at the domain boundary.
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/clean/maybe
+ * 
+ * @namespace C
+ * 
+ */
+export type Maybe<GenericEntity extends Entity = Entity> = (Some<GenericEntity> | None<GetKindValue<typeof entityKind, GenericEntity>>);
+/**
+ * Constructor that creates a `Maybe` success branch from an entity.
+ * 
+ * **Supported call styles:**
+ * - Classic: `some(entity)` -> returns `Some<Entity>`
+ * - Pipe-compatible: `pipe(entity, some)`
+ * 
+ * Use `some` when the expected entity is available and must satisfy a `Maybe<Entity>` contract.
+ * 
+ * ```ts
+ * const UserId = C.createNewType("userId", DPE.number());
+ * const User = C.createEntity("User", () => ({
+ * 	id: UserId,
+ * }));
+ * 
+ * const firstUser = User.new({
+ * 	id: UserId.createOrThrow(1),
+ * });
+ * const firstMaybe = C.some(firstUser);
+ * // firstMaybe: C.Some<typeof firstUser>
+ * 
+ * const secondUser = User.new({
+ * 	id: UserId.createOrThrow(2),
+ * });
+ * const secondMaybe = C.some(secondUser);
+ * // secondMaybe: C.Some<typeof secondUser>
+ * 
+ * const pipedMaybe = pipe(
+ * 	firstUser,
+ * 	C.some,
+ * );
+ * 
+ * type check = ExpectType<
+ * 	typeof pipedMaybe,
+ * 	C.Some<typeof firstUser>,
+ * 	"strict"
+ * >;
+ * 
+ * ```
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/clean/maybe
+ * 
+ * @namespace C
+ * 
+ */
+export declare function some<GenericEntity extends Entity>(entity: GenericEntity): Some<GenericEntity>;
+/**
+ * Constructor that creates a `Maybe` empty branch from an entity name.
+ * 
+ * **Supported call styles:**
+ * - Classic: `none(entityName)` -> returns `None<entityName>`
+ * - Pipe-compatible: `pipe(entityName, none)`
+ * 
+ * Use `none` when an entity is absent but you still want to keep a precise business contract with `Maybe<Entity>`.
+ * 
+ * ```ts
+ * const noUser = C.none("User");
+ * // noUser: C.None<"User">
+ * 
+ * const noOrder = C.none("Order");
+ * // noOrder: C.None<"Order">
+ * 
+ * const pipedNone = pipe(
+ * 	"Invoice",
+ * 	C.none,
+ * );
+ * 
+ * type check = ExpectType<
+ * 	typeof pipedNone,
+ * 	C.None<"Invoice">,
+ * 	"strict"
+ * >;
+ * 
+ * ```
+ * 
+ * @see https://utils.duplojs.dev/en/v1/api/clean/maybe
+ * 
+ * @namespace C
+ * 
+ */
+export declare function none<GenericEntityName extends string>(entityName: GenericEntityName): None<GenericEntityName>;

package/dist/clean/maybe.mjs

@@ -0,0 +1,18 @@
+import { entityKind } from './entity.mjs';
+import { right } from '../either/right/create.mjs';
+import { left } from '../either/left/create.mjs';
+
+/**
+ * {@include clean/some/index.md}
+ */
+function some(entity) {
+    return right(`some-${entityKind.getValue(entity)}`, entity);
+}
+/**
+ * {@include clean/none/index.md}
+ */
+function none(entityName) {
+    return left(`none-${entityName}`, null);
+}
+
+export { none, some };

package/dist/clean/newType.cjs

@@ -8,13 +8,14 @@ var pipe = require('../common/pipe.cjs');
 var map = require('../array/map.cjs');
 var entry = require('../object/entry.cjs');
 var errorKindNamespace = require('../common/errorKindNamespace.cjs');
+var fromEntries = require('../object/fromEntries.cjs');
+var override = require('../common/override.cjs');
 var is = require('../either/left/is.cjs');
 var unwrap = require('../common/unwrap.cjs');
 var create = require('../either/left/create.cjs');
 var base = require('./constraint/base.cjs');
 var create$1 = require('../either/right/create.cjs');
 var wrapValue = require('../common/wrapValue.cjs');
-var fromEntries = require('../object/fromEntries.cjs');
 
 const newTypeKind = kind.createCleanKind("new-type");
 const newTypeHandlerKind = kind.createCleanKind("new-type-handler");
@@ -80,7 +81,7 @@ function createNewType(name, dataParser, constraint) {
         }
         return true;
     }
-    return newTypeHandlerKind.setTo({
+    return pipe.pipe({
         name,
         dataParser: dataParserWithCheckers,
         constrains: constraints,
@@ -90,8 +91,9 @@ function createNewType(name, dataParser, constraint) {
         createWithUnknown: create$2,
         createWithUnknownOrThrow: createOrThrow,
         is: is$1,
-    });
+    }, newTypeHandlerKind.setTo, createNewType.overrideHandler.apply);
 }
+createNewType.overrideHandler = override.createOverride("@duplojs/utils/clean/new-type");
 
 exports.CreateNewTypeError = CreateNewTypeError;
 exports.createNewType = createNewType;

package/dist/clean/newType.d.ts

@@ -151,5 +151,8 @@ export declare function createNewType<GenericName extends string, GenericDataPar
     ConstraintHandler<string, EligiblePrimitive, readonly DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, DDataParser.Output<GenericDataParser>>[]>,
     ...ConstraintHandler<string, EligiblePrimitive, readonly DDataParser.DataParserChecker<DDataParser.DataParserCheckerDefinition, DDataParser.Output<GenericDataParser>>[]>[]
 ]) = never>(name: GenericName, dataParser: GenericDataParser & DataParserContainTransform<GenericDataParser>, constraint?: GenericConstraintsHandler): NewTypeHandler<GenericName, DeepReadonly<DDataParser.Output<GenericDataParser>>, DArray.ArrayCoalescing<NeverCoalescing<GenericConstraintsHandler, readonly []>>>;
+export declare namespace createNewType {
+    var overrideHandler: import("..").OverrideHandler<NewTypeHandler<string, unknown, readonly []>>;
+}
 export type GetNewType<GenericHandler extends NewTypeHandler<string, unknown, readonly any[]>> = Extract<GenericHandler extends any ? NewType<GenericHandler["name"], DDataParser.Output<GenericHandler["dataParser"]>, GenericHandler["constrains"][number]["name"]> : never, any>;
 export {};