moost 0.6.28 → 0.6.30

package/dist/index.cjs

@@ -65,14 +65,24 @@ function runPipes(pipes, initialValue, metas, level) {
 
 //#endregion
 //#region packages/moost/src/metadata/moost-metadata.ts
-const moostMate = new _prostojs_mate.Mate("moost", {
+const METADATA_WORKSPACE = "moost";
+/**
+* A param entry is "bare" when it carries nothing but the design-time type
+* (auto-captured from `design:paramtypes` the moment any decorator touches the
+* method). Bare entries mean the override declared no param decorators of its
+* own, so the parent's param metadata (resolvers, pipes, …) should survive.
+*/ function isBareParam(param) {
+	return !param || Object.entries(param).every(([key, value]) => key === "type" || value === void 0);
+}
+const moostMate = new _prostojs_mate.Mate(METADATA_WORKSPACE, {
 	readType: true,
 	readReturnType: true,
 	collectPropKeys: true,
 	inherit(classMeta, targetMeta, level) {
+		if (targetMeta?.inherit === false) return false;
 		if (level === "CLASS") return !!classMeta?.inherit;
-		if (level === "PROP") return !!targetMeta?.inherit || !!(classMeta?.inherit && !targetMeta);
-		return !!targetMeta?.inherit;
+		if (level === "PROP") return !!targetMeta?.inherit || !!classMeta?.inherit;
+		return !!targetMeta?.inherit || isBareParam(targetMeta);
 	}
 });
 /** Returns the shared `Mate` instance operating in the `'moost'` metadata workspace. */ function getMoostMate() {
@@ -695,9 +705,22 @@ function fillLabel(target, key, index, name) {
 /**
 * ## Inherit
 * ### @Decorator
-* Inherit metadata from super class
-* @returns
-*/ const Inherit = () => getMoostMate().decorate("inherit", true);
+* Enables metadata inheritance from the super class. Goes on the **inheriting
+* subclass** (the class whose metadata is being read), not on the base class.
+*
+* - On a class: class-level metadata is merged from the parent (own keys win),
+*   and every method/prop inherits the parent's metadata — including decorated
+*   overrides, which merge the parent's metadata under their own (so adding
+*   e.g. a rate-limit decorator to an override does not unbind the parent's
+*   `@Get`/`@Post` route).
+* - On a method/prop: enables inheritance for just that member.
+* - `@Inherit(false)` on an overridden member opts out of the merge for a
+*   deliberate full replacement (the member keeps only its own metadata).
+*
+* Note: constructor param metadata is inherited automatically when the
+* subclass declares no constructor of its own; a subclass that declares a
+* constructor uses its own params only.
+*/ const Inherit = (inherit = true) => getMoostMate().decorate("inherit", inherit);
 
 //#endregion
 //#region packages/moost/src/decorators/init.decorator.ts

package/dist/index.d.ts

@@ -575,10 +575,23 @@ declare function HandlerPaths(method?: string, opts?: TGetHandlerPathsOptions):
 /**
  * ## Inherit
  * ### @Decorator
- * Inherit metadata from super class
- * @returns
+ * Enables metadata inheritance from the super class. Goes on the **inheriting
+ * subclass** (the class whose metadata is being read), not on the base class.
+ *
+ * - On a class: class-level metadata is merged from the parent (own keys win),
+ *   and every method/prop inherits the parent's metadata — including decorated
+ *   overrides, which merge the parent's metadata under their own (so adding
+ *   e.g. a rate-limit decorator to an override does not unbind the parent's
+ *   `@Get`/`@Post` route).
+ * - On a method/prop: enables inheritance for just that member.
+ * - `@Inherit(false)` on an overridden member opts out of the merge for a
+ *   deliberate full replacement (the member keeps only its own metadata).
+ *
+ * Note: constructor param metadata is inherited automatically when the
+ * subclass declares no constructor of its own; a subclass that declares a
+ * constructor uses its own params only.
  */
-declare const Inherit: () => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
+declare const Inherit: (inherit?: boolean) => MethodDecorator & ClassDecorator & ParameterDecorator & PropertyDecorator;
 
 /**
  * ## MoostInit

package/dist/index.mjs

@@ -64,14 +64,24 @@ function runPipes(pipes, initialValue, metas, level) {
 
 //#endregion
 //#region packages/moost/src/metadata/moost-metadata.ts
-const moostMate = new Mate("moost", {
+const METADATA_WORKSPACE = "moost";
+/**
+* A param entry is "bare" when it carries nothing but the design-time type
+* (auto-captured from `design:paramtypes` the moment any decorator touches the
+* method). Bare entries mean the override declared no param decorators of its
+* own, so the parent's param metadata (resolvers, pipes, …) should survive.
+*/ function isBareParam(param) {
+	return !param || Object.entries(param).every(([key, value]) => key === "type" || value === void 0);
+}
+const moostMate = new Mate(METADATA_WORKSPACE, {
 	readType: true,
 	readReturnType: true,
 	collectPropKeys: true,
 	inherit(classMeta, targetMeta, level) {
+		if (targetMeta?.inherit === false) return false;
 		if (level === "CLASS") return !!classMeta?.inherit;
-		if (level === "PROP") return !!targetMeta?.inherit || !!(classMeta?.inherit && !targetMeta);
-		return !!targetMeta?.inherit;
+		if (level === "PROP") return !!targetMeta?.inherit || !!classMeta?.inherit;
+		return !!targetMeta?.inherit || isBareParam(targetMeta);
 	}
 });
 /** Returns the shared `Mate` instance operating in the `'moost'` metadata workspace. */ function getMoostMate() {
@@ -694,9 +704,22 @@ function fillLabel(target, key, index, name) {
 /**
 * ## Inherit
 * ### @Decorator
-* Inherit metadata from super class
-* @returns
-*/ const Inherit = () => getMoostMate().decorate("inherit", true);
+* Enables metadata inheritance from the super class. Goes on the **inheriting
+* subclass** (the class whose metadata is being read), not on the base class.
+*
+* - On a class: class-level metadata is merged from the parent (own keys win),
+*   and every method/prop inherits the parent's metadata — including decorated
+*   overrides, which merge the parent's metadata under their own (so adding
+*   e.g. a rate-limit decorator to an override does not unbind the parent's
+*   `@Get`/`@Post` route).
+* - On a method/prop: enables inheritance for just that member.
+* - `@Inherit(false)` on an overridden member opts out of the merge for a
+*   deliberate full replacement (the member keeps only its own metadata).
+*
+* Note: constructor param metadata is inherited automatically when the
+* subclass declares no constructor of its own; a subclass that declares a
+* constructor uses its own params only.
+*/ const Inherit = (inherit = true) => getMoostMate().decorate("inherit", inherit);
 
 //#endregion
 //#region packages/moost/src/decorators/init.decorator.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moost",
-  "version": "0.6.28",
+  "version": "0.6.30",
   "description": "moost",
   "keywords": [
     "composables",
@@ -49,7 +49,7 @@
     "@wooksjs/event-http": "^0.7.19",
     "@wooksjs/http-body": "^0.7.19",
     "vitest": "3.2.4",
-    "@moostjs/event-http": "^0.6.28"
+    "@moostjs/event-http": "^0.6.30"
   },
   "scripts": {
     "pub": "pnpm publish --access public",