typesea 0.1.0 → 0.3.0

package/dist/builders/modifier.d.ts

@@ -1,26 +1,57 @@
 /**
  * @file modifier.ts
  * @brief Presence, lazy, and refinement guard builders.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 import { BaseGuard, type Guard, type GuardPresence, type GuardValue, type Infer, type Presence } from "../guard/index.js";
 /**
- * @brief optional.
+ * @brief Mark a guard optional for object shape construction.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard whose value type is preserved.
+ * @returns Fresh optional guard.
  */
 export declare function optional<TGuard extends Guard<unknown, Presence>>(guard: TGuard): BaseGuard<GuardValue<TGuard>, "optional">;
 /**
- * @brief undefinedable.
+ * @brief Allow explicit undefined as a value.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard to wrap.
+ * @returns Fresh undefinedable guard preserving original presence.
  */
 export declare function undefinedable<TGuard extends Guard<unknown, Presence>>(guard: TGuard): BaseGuard<GuardValue<TGuard> | undefined, GuardPresence<TGuard>>;
 /**
- * @brief nullable.
+ * @brief Allow explicit null as a value.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard to wrap.
+ * @returns Fresh nullable guard preserving original presence.
  */
 export declare function nullable<TGuard extends Guard<unknown, Presence>>(guard: TGuard): BaseGuard<GuardValue<TGuard> | null, GuardPresence<TGuard>>;
 /**
- * @brief lazy.
+ * @brief Allow null, undefined, and absent object keys.
+ * @param guard Guard to wrap.
+ * @returns Fresh optional guard whose value domain also includes null.
+ */
+export declare function nullish<TGuard extends Guard<unknown, Presence>>(guard: TGuard): BaseGuard<GuardValue<TGuard> | null, "optional">;
+/**
+ * @brief Resolve recursive schemas once and reuse the frozen schema handle.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param get Resolver returning the recursive guard.
+ * @returns Fresh lazy guard.
+ * @throws TypeError when the resolver is not callable.
  */
 export declare function lazy<TGuard extends Guard<unknown, Presence>>(get: () => TGuard): BaseGuard<Infer<TGuard>>;
 /**
- * @brief refine.
+ * @brief Attach a boolean refinement while preserving TypeSea's strict true contract.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard that must pass before the predicate runs.
+ * @param predicate User predicate that must return the boolean literal true.
+ * @param name Diagnostic name for refinement failures.
+ * @returns Fresh refined guard.
  */
 export declare function refine<TGuard extends Guard<unknown, Presence>>(guard: TGuard, predicate: (value: Infer<TGuard>) => boolean, name: string): BaseGuard<GuardValue<TGuard>, GuardPresence<TGuard>>;
 //# sourceMappingURL=modifier.d.ts.map

package/dist/builders/modifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modifier.d.ts","sourceRoot":"","sources":["../../src/builders/modifier.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,SAAS,EACT,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAI3B;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC9D,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAK3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EACnE,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC9D,KAAK,EAAE,MAAM,GACZ,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAK7D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC1D,GAAG,EAAE,MAAM,MAAM,GAChB,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAY1B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5D,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,EAC5C,IAAI,EAAE,MAAM,GACX,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CActD"}
+{"version":3,"file":"modifier.d.ts","sourceRoot":"","sources":["../../src/builders/modifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACH,SAAS,EACT,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,QAAQ,EAChB,MAAM,mBAAmB,CAAC;AAI3B;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5D,KAAK,EAAE,MAAM,GACd,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAK3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EACjE,KAAK,EAAE,MAAM,GACd,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAKlE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5D,KAAK,EAAE,MAAM,GACd,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC3D,KAAK,EAAE,MAAM,GACd,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAQlD;AAED;;;;;;;GAOG;AACH,wBAAgB,IAAI,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EACxD,GAAG,EAAE,MAAM,MAAM,GAClB,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAgB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,SAAS,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC1D,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,EAC5C,IAAI,EAAE,MAAM,GACb,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAkBtD"}

package/dist/builders/modifier.js

@@ -1,12 +1,18 @@
 /**
  * @file modifier.ts
  * @brief Presence, lazy, and refinement guard builders.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 import { SchemaTag } from "../kind/index.js";
 import { BaseGuard } from "../guard/index.js";
 import { isStrictTrue, readGuardSchema } from "../internal/index.js";
 /**
- * @brief optional.
+ * @brief Mark a guard optional for object shape construction.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard whose value type is preserved.
+ * @returns Fresh optional guard.
  */
 export function optional(guard) {
     return new BaseGuard({
@@ -15,7 +21,11 @@ export function optional(guard) {
     });
 }
 /**
- * @brief undefinedable.
+ * @brief Allow explicit undefined as a value.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard to wrap.
+ * @returns Fresh undefinedable guard preserving original presence.
  */
 export function undefinedable(guard) {
     return new BaseGuard({
@@ -24,7 +34,11 @@ export function undefinedable(guard) {
     });
 }
 /**
- * @brief nullable.
+ * @brief Allow explicit null as a value.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard to wrap.
+ * @returns Fresh nullable guard preserving original presence.
  */
 export function nullable(guard) {
     return new BaseGuard({
@@ -33,7 +47,26 @@ export function nullable(guard) {
     });
 }
 /**
- * @brief lazy.
+ * @brief Allow null, undefined, and absent object keys.
+ * @param guard Guard to wrap.
+ * @returns Fresh optional guard whose value domain also includes null.
+ */
+export function nullish(guard) {
+    return new BaseGuard({
+        tag: SchemaTag.Optional,
+        inner: {
+            tag: SchemaTag.Nullable,
+            inner: readGuardSchema(guard, "nullish inner")
+        }
+    });
+}
+/**
+ * @brief Resolve recursive schemas once and reuse the frozen schema handle.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param get Resolver returning the recursive guard.
+ * @returns Fresh lazy guard.
+ * @throws TypeError when the resolver is not callable.
  */
 export function lazy(get) {
     if (typeof get !== "function") {
@@ -43,13 +76,23 @@ export function lazy(get) {
     return new BaseGuard({
         tag: SchemaTag.Lazy,
         get: () => {
+            /*
+             * Cache the resolved schema rather than the guard wrapper. This keeps
+             * recursive validation stable after the first successful resolution.
+             */
             cached ??= readGuardSchema(get(), "lazy result");
             return cached;
         }
     });
 }
 /**
- * @brief refine.
+ * @brief Attach a boolean refinement while preserving TypeSea's strict true contract.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
+ * @param guard Guard that must pass before the predicate runs.
+ * @param predicate User predicate that must return the boolean literal true.
+ * @param name Diagnostic name for refinement failures.
+ * @returns Fresh refined guard.
  */
 export function refine(guard, predicate, name) {
     if (typeof predicate !== "function") {
@@ -61,6 +104,10 @@ export function refine(guard, predicate, name) {
     return new BaseGuard({
         tag: SchemaTag.Refine,
         inner: readGuardSchema(guard, "refine inner"),
+        /*
+         * Truthy non-boolean values are rejected. This keeps refinement behavior
+         * identical between interpreted and compiled validation paths.
+         */
         predicate: (value) => isStrictTrue(predicate(value)),
         name
     });

package/dist/builders/object/guard.d.ts

@@ -1,62 +1,110 @@
 /**
  * @file guard.ts
  * @brief Object guard class and object builder API.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 import type { ObjectSchema } from "../../schema/index.js";
 import { ObjectModeTag } from "../../kind/index.js";
-import { BaseGuard } from "../../guard/index.js";
-import type { ObjectGuardMode, ObjectShape, InferObject, MergeObjectShapes, OmitObjectShape, PartialObjectShape, PickObjectShape, StringKeyOf } from "./types.js";
+import { BaseGuard, type Guard, type Presence } from "../../guard/index.js";
+import type { ObjectGuardMode, ObjectShape, DeepPartialObjectShape, InferObject, MergeObjectShapes, ObjectKeyMask, OmitObjectShape, OmitObjectShapeByMask, PartialObjectShape, PickObjectShape, PickObjectShapeByMask, RequiredObjectShape, StringKeyOf } from "./types.js";
 /**
  * @brief Guard subclass with object-specific shape operations.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  *
  * @invariant Methods preserve the original object mode. Strict schemas stay
  * strict after shape edits; passthrough schemas stay passthrough.
  */
 export declare class ObjectGuard<TShape extends ObjectShape, TMode extends ObjectGuardMode> extends BaseGuard<InferObject<TShape>> {
-    /**
-     * @brief constructor.
-         * @post The receiver is initialized according to the class invariant before it can be observed.
-     */
     constructor(schema: ObjectSchema);
-    /**
-     * @brief extend.
-           */
     extend<const TExtension extends ObjectShape>(extension: TExtension): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
-    /**
-     * @brief pick.
-           */
+    safeExtend<const TExtension extends ObjectShape>(extension: TExtension): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
+    merge<const TExtension extends ObjectShape, TExtensionMode extends ObjectGuardMode>(other: ObjectGuard<TExtension, TExtensionMode>): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
     pick<const TKeys extends readonly StringKeyOf<TShape>[]>(keys: TKeys): ObjectGuard<PickObjectShape<TShape, TKeys[number]>, TMode>;
-    /**
-     * @brief omit.
-           */
+    pick<const TMask extends ObjectKeyMask<TShape>>(keys: TMask): ObjectGuard<PickObjectShapeByMask<TShape, TMask>, TMode>;
     omit<const TKeys extends readonly StringKeyOf<TShape>[]>(keys: TKeys): ObjectGuard<OmitObjectShape<TShape, TKeys[number]>, TMode>;
-    /**
-     * @brief partial.
-         */
+    omit<const TMask extends ObjectKeyMask<TShape>>(keys: TMask): ObjectGuard<OmitObjectShapeByMask<TShape, TMask>, TMode>;
     partial(): ObjectGuard<PartialObjectShape<TShape>, TMode>;
+    deepPartial(): ObjectGuard<DeepPartialObjectShape<TShape>, TMode>;
+    required(): ObjectGuard<RequiredObjectShape<TShape>, TMode>;
+    strict(): ObjectGuard<TShape, typeof ObjectModeTag.Strict>;
+    passthrough(): ObjectGuard<TShape, typeof ObjectModeTag.Passthrough>;
+    strip(): ObjectGuard<TShape, typeof ObjectModeTag.Passthrough>;
+    catchall(guard: Guard<unknown, Presence>): ObjectGuard<TShape, TMode>;
 }
 /**
- * @brief object.
+ * @brief Build an object guard that accepts unspecified enumerable keys.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 export declare function object<const TShape extends ObjectShape>(shape: TShape): ObjectGuard<TShape, typeof ObjectModeTag.Passthrough>;
 /**
- * @brief strict object.
+ * @brief Build an object guard that rejects unspecified own keys.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 export declare function strictObject<const TShape extends ObjectShape>(shape: TShape): ObjectGuard<TShape, typeof ObjectModeTag.Strict>;
 /**
- * @brief extend.
+ * @brief Execute extend.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export declare function extend<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TExtension extends ObjectShape>(guard: ObjectGuard<TShape, TMode>, extension: TExtension): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
 /**
- * @brief pick.
+ * @brief Execute safe extend.
+ * @details Runtime construction follows the same hardened schema merge as
+ * extend. The method name gives callers a Zod-compatible, intention-revealing
+ * API for shape extension.
+ */
+export declare function safeExtend<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TExtension extends ObjectShape>(guard: ObjectGuard<TShape, TMode>, extension: TExtension): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
+/**
+ * @brief Execute object merge.
+ * @details The left object keeps its unknown-key mode. The right object supplies
+ * overriding fields and, when present, a catchall schema.
+ */
+export declare function merge<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TExtension extends ObjectShape, TExtensionMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>, other: ObjectGuard<TExtension, TExtensionMode>): ObjectGuard<MergeObjectShapes<TShape, TExtension>, TMode>;
+/**
+ * @brief Execute pick.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export declare function pick<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TKeys extends readonly StringKeyOf<TShape>[]>(guard: ObjectGuard<TShape, TMode>, keys: TKeys): ObjectGuard<PickObjectShape<TShape, TKeys[number]>, TMode>;
+export declare function pick<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TMask extends ObjectKeyMask<TShape>>(guard: ObjectGuard<TShape, TMode>, keys: TMask): ObjectGuard<PickObjectShapeByMask<TShape, TMask>, TMode>;
 /**
- * @brief omit.
+ * @brief Execute omit.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export declare function omit<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TKeys extends readonly StringKeyOf<TShape>[]>(guard: ObjectGuard<TShape, TMode>, keys: TKeys): ObjectGuard<OmitObjectShape<TShape, TKeys[number]>, TMode>;
+export declare function omit<const TShape extends ObjectShape, TMode extends ObjectGuardMode, const TMask extends ObjectKeyMask<TShape>>(guard: ObjectGuard<TShape, TMode>, keys: TMask): ObjectGuard<OmitObjectShapeByMask<TShape, TMask>, TMode>;
 /**
- * @brief partial.
+ * @brief Execute partial.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export declare function partial<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<PartialObjectShape<TShape>, TMode>;
+/**
+ * @brief Execute deep partial.
+ */
+export declare function deepPartial<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<DeepPartialObjectShape<TShape>, TMode>;
+/**
+ * @brief Execute required.
+ * @details This helper keeps a local invariant explicit at the module boundary.
+ */
+export declare function required<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<RequiredObjectShape<TShape>, TMode>;
+/**
+ * @brief Convert an object guard to strict unknown-key policy.
+ */
+export declare function strict<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<TShape, typeof ObjectModeTag.Strict>;
+/**
+ * @brief Convert an object guard to passthrough unknown-key policy.
+ */
+export declare function passthrough<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<TShape, typeof ObjectModeTag.Passthrough>;
+/**
+ * @brief Accept unknown keys without producing a stripped output copy.
+ * @details TypeSea guard validation returns the original value, so Zod-style
+ * strip has validation semantics equivalent to passthrough.
+ */
+export declare function strip<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>): ObjectGuard<TShape, typeof ObjectModeTag.Passthrough>;
+/**
+ * @brief Validate every undeclared own key with a catchall schema.
+ */
+export declare function catchall<const TShape extends ObjectShape, TMode extends ObjectGuardMode>(guard: ObjectGuard<TShape, TMode>, value: Guard<unknown, Presence>): ObjectGuard<TShape, TMode>;
 //# sourceMappingURL=guard.d.ts.map

package/dist/builders/object/guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/builders/object/guard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/builders/object/guard.ts"],"names":[],"mappings":"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"}

package/dist/builders/object/guard.js

@@ -1,95 +1,174 @@
 /**
  * @file guard.ts
  * @brief Object guard class and object builder API.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 import { ObjectModeTag } from "../../kind/index.js";
 import { BaseGuard } from "../../guard/index.js";
-import { mergeObjectSchemas, objectSchema, omitObjectSchema, partialObjectSchema, pickObjectSchema, readObjectConstructorSchema, readObjectKeySelection, readObjectMethodSchema } from "./schema.js";
+import { readGuardSchema } from "../../internal/index.js";
+import { deepPartialObjectSchema, mergeObjectSchemas, objectSchema, objectSchemaWithCatchall, objectSchemaWithMode, omitObjectSchema, partialObjectSchema, pickObjectSchema, readObjectConstructorSchema, readObjectKeySelection, readObjectMethodSchema, requiredObjectSchema } from "./schema.js";
 /**
  * @brief Guard subclass with object-specific shape operations.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  *
  * @invariant Methods preserve the original object mode. Strict schemas stay
  * strict after shape edits; passthrough schemas stay passthrough.
  */
 export class ObjectGuard extends BaseGuard {
-    /**
-     * @brief constructor.
-         * @post The receiver is initialized according to the class invariant before it can be observed.
-     */
     constructor(schema) {
         super(readObjectConstructorSchema(schema));
         Object.freeze(this);
     }
-    /**
-     * @brief extend.
-           */
     extend(extension) {
         return extendObjectGuard(this, extension);
     }
-    /**
-     * @brief pick.
-           */
+    safeExtend(extension) {
+        return extendObjectGuard(this, extension);
+    }
+    merge(other) {
+        return mergeObjectGuard(this, other);
+    }
     pick(keys) {
         return pickObjectGuard(this, keys);
     }
-    /**
-     * @brief omit.
-           */
     omit(keys) {
         return omitObjectGuard(this, keys);
     }
-    /**
-     * @brief partial.
-         */
     partial() {
         return partialObjectGuard(this);
     }
+    deepPartial() {
+        return deepPartialObjectGuard(this);
+    }
+    required() {
+        return requiredObjectGuard(this);
+    }
+    strict() {
+        return objectModeGuard(this, ObjectModeTag.Strict);
+    }
+    passthrough() {
+        return objectModeGuard(this, ObjectModeTag.Passthrough);
+    }
+    strip() {
+        return objectModeGuard(this, ObjectModeTag.Passthrough);
+    }
+    catchall(guard) {
+        return catchallObjectGuard(this, guard);
+    }
 }
 /**
- * @brief object.
+ * @brief Build an object guard that accepts unspecified enumerable keys.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 export function object(shape) {
     return new ObjectGuard(objectSchema(shape, ObjectModeTag.Passthrough));
 }
 /**
- * @brief strict object.
+ * @brief Build an object guard that rejects unspecified own keys.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
 export function strictObject(shape) {
     return new ObjectGuard(objectSchema(shape, ObjectModeTag.Strict));
 }
 /**
- * @brief extend.
+ * @brief Execute extend.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export function extend(guard, extension) {
     return extendObjectGuard(guard, extension);
 }
 /**
- * @brief pick.
+ * @brief Execute safe extend.
+ * @details Runtime construction follows the same hardened schema merge as
+ * extend. The method name gives callers a Zod-compatible, intention-revealing
+ * API for shape extension.
  */
-export function pick(guard, keys) {
-    return pickObjectGuard(guard, keys);
+export function safeExtend(guard, extension) {
+    return extendObjectGuard(guard, extension);
 }
 /**
- * @brief omit.
+ * @brief Execute object merge.
+ * @details The left object keeps its unknown-key mode. The right object supplies
+ * overriding fields and, when present, a catchall schema.
  */
+export function merge(guard, other) {
+    return mergeObjectGuard(guard, other);
+}
+export function pick(guard, keys) {
+    return pickObjectGuard(guard, keys);
+}
 export function omit(guard, keys) {
     return omitObjectGuard(guard, keys);
 }
 /**
- * @brief partial.
+ * @brief Execute partial.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 export function partial(guard) {
     return partialObjectGuard(guard);
 }
 /**
- * @brief extend object guard.
+ * @brief Execute deep partial.
+ */
+export function deepPartial(guard) {
+    return deepPartialObjectGuard(guard);
+}
+/**
+ * @brief Execute required.
+ * @details This helper keeps a local invariant explicit at the module boundary.
+ */
+export function required(guard) {
+    return requiredObjectGuard(guard);
+}
+/**
+ * @brief Convert an object guard to strict unknown-key policy.
+ */
+export function strict(guard) {
+    return objectModeGuard(guard, ObjectModeTag.Strict);
+}
+/**
+ * @brief Convert an object guard to passthrough unknown-key policy.
+ */
+export function passthrough(guard) {
+    return objectModeGuard(guard, ObjectModeTag.Passthrough);
+}
+/**
+ * @brief Accept unknown keys without producing a stripped output copy.
+ * @details TypeSea guard validation returns the original value, so Zod-style
+ * strip has validation semantics equivalent to passthrough.
+ */
+export function strip(guard) {
+    return objectModeGuard(guard, ObjectModeTag.Passthrough);
+}
+/**
+ * @brief Validate every undeclared own key with a catchall schema.
+ */
+export function catchall(guard, value) {
+    return catchallObjectGuard(guard, value);
+}
+/**
+ * @brief Execute extend object guard.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 function extendObjectGuard(guard, extension) {
     const schema = readObjectMethodSchema(guard, "object extend receiver");
     return new ObjectGuard(mergeObjectSchemas(schema, objectSchema(extension, schema.mode)));
 }
 /**
- * @brief pick object guard.
+ * @brief Execute merge object guard.
+ */
+function mergeObjectGuard(guard, other) {
+    const base = readObjectMethodSchema(guard, "object merge receiver");
+    const extension = readObjectMethodSchema(other, "object merge argument");
+    return new ObjectGuard(mergeObjectSchemas(base, extension));
+}
+/**
+ * @brief Execute pick object guard.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 function pickObjectGuard(guard, keys) {
     const schema = readObjectMethodSchema(guard, "object pick receiver");
@@ -97,7 +176,8 @@ function pickObjectGuard(guard, keys) {
     return new ObjectGuard(pickObjectSchema(schema, selection));
 }
 /**
- * @brief omit object guard.
+ * @brief Execute omit object guard.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 function omitObjectGuard(guard, keys) {
     const schema = readObjectMethodSchema(guard, "object omit receiver");
@@ -105,9 +185,39 @@ function omitObjectGuard(guard, keys) {
     return new ObjectGuard(omitObjectSchema(schema, selection));
 }
 /**
- * @brief partial object guard.
+ * @brief Execute partial object guard.
+ * @details This helper keeps a local invariant explicit at the module boundary.
  */
 function partialObjectGuard(guard) {
     const schema = readObjectMethodSchema(guard, "object partial receiver");
     return new ObjectGuard(partialObjectSchema(schema));
 }
+/**
+ * @brief Execute deep partial object guard.
+ */
+function deepPartialObjectGuard(guard) {
+    const schema = readObjectMethodSchema(guard, "object deepPartial receiver");
+    return new ObjectGuard(deepPartialObjectSchema(schema));
+}
+/**
+ * @brief Execute required object guard.
+ * @details This helper keeps a local invariant explicit at the module boundary.
+ */
+function requiredObjectGuard(guard) {
+    const schema = readObjectMethodSchema(guard, "object required receiver");
+    return new ObjectGuard(requiredObjectSchema(schema));
+}
+/**
+ * @brief Execute object mode rewrite.
+ */
+function objectModeGuard(guard, mode) {
+    const schema = readObjectMethodSchema(guard, "object mode receiver");
+    return new ObjectGuard(objectSchemaWithMode(schema, mode));
+}
+/**
+ * @brief Execute object catchall rewrite.
+ */
+function catchallObjectGuard(guard, value) {
+    const schema = readObjectMethodSchema(guard, "object catchall receiver");
+    return new ObjectGuard(objectSchemaWithCatchall(schema, readGuardSchema(value, "object catchall schema")));
+}

package/dist/builders/object/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * @file index.ts
  * @brief Public object builder aggregation.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
-export { ObjectGuard, extend, object, omit, partial, pick, strictObject } from "./guard.js";
-export type { InferObject, MergeObjectShapes, ObjectGuardMode, ObjectShape, OmitObjectShape, PartialObjectShape, PickObjectShape } from "./types.js";
+export { ObjectGuard, catchall, deepPartial, extend, merge, object, omit, partial, passthrough, pick, required, safeExtend, strict, strictObject, strip } from "./guard.js";
+export type { DeepPartialObjectShape, DeepPartialValue, InferObject, MaskSelectedKeys, MergeObjectShapes, ObjectKeyMask, ObjectGuardMode, ObjectShape, OmitObjectShape, OmitObjectShapeByMask, PartialObjectShape, PickObjectShape, PickObjectShapeByMask, RequiredObjectShape } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/builders/object/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/object/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,YAAY,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/object/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,WAAW,EACX,QAAQ,EACR,WAAW,EACX,MAAM,EACN,KAAK,EACL,MAAM,EACN,IAAI,EACJ,OAAO,EACP,WAAW,EACX,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,MAAM,EACN,YAAY,EACZ,KAAK,EACR,MAAM,YAAY,CAAC;AACpB,YAAY,EACR,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACtB,MAAM,YAAY,CAAC"}

package/dist/builders/object/index.js

@@ -1,5 +1,7 @@
 /**
  * @file index.ts
  * @brief Public object builder aggregation.
+ * @details Builder helpers normalize user-facing fluent calls into immutable schema nodes
+ * with stable metadata.
  */
-export { ObjectGuard, extend, object, omit, partial, pick, strictObject } from "./guard.js";
+export { ObjectGuard, catchall, deepPartial, extend, merge, object, omit, partial, passthrough, pick, required, safeExtend, strict, strictObject, strip } from "./guard.js";