[DOC release] Fix API doc issues with package split. (#6280)

* [DOC release] Remove @for DS

* [DOC release] Add @module declaration to each package file.

* [DOC release] Remove @namespace DS usage.

* [DOC release] Remove @namespace usage.

packages/-ember-data/addon/-private/system/debug/debug-adapter.js

@@ -14,7 +14,6 @@ import Model from '@ember-data/model';
   Extend `Ember.DataAdapter` with ED specific code.
 
   @class DebugAdapter
-  @namespace DS
   @extends Ember.DataAdapter
   @private
 */

packages/adapter/addon/-private/build-url-mixin.js

@@ -3,6 +3,10 @@ import Mixin from '@ember/object/mixin';
 import { get } from '@ember/object';
 import { pluralize } from 'ember-inflector';
 
+/**
+  @module @ember-data/adapter
+*/
+
 /**
 
   WARNING: This interface is likely to change in order to accommodate [RFC: Ember Data url templates](https://github.com/emberjs/rfcs/pull/4)
@@ -30,7 +34,6 @@ import { pluralize } from 'ember-inflector';
   The `host` and `namespace` attributes will be used if defined, and are optional.
 
   @class BuildURLMixin
-  @namespace DS
 */
 export default Mixin.create({
   /**

packages/adapter/addon/-private/index.js

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/adapter
+*/
+
 export { default as parseResponseHeaders } from './utils/parse-response-headers';
 export { determineBodyPromise } from './utils/determine-body-promise';
 export { serializeQueryParams } from './utils/serialize-query-params';

packages/adapter/addon/-private/utils/determine-body-promise.ts

@@ -1,4 +1,4 @@
-/**
+/*
  * Function that always attempts to parse the response as json, and if an error is thrown,
  * returns `undefined` if the response is successful and has a status code of 204 (No Content),
  * or 205 (Reset Content) or if the request method was 'HEAD', and the plain payload otherwise.

packages/adapter/addon/-private/utils/serialize-query-params.ts

@@ -4,7 +4,7 @@ function isPlainObject(obj: any): boolean {
   return Object.prototype.toString.call(obj) === '[object Object]';
 }
 
-/**
+/*
  * Helper function that turns the data/body of a request into a query param string.
  * This is directly copied from jQuery.param.
  */
@@ -52,7 +52,7 @@ export function serializeQueryParams(
     .replace(/%20/g, '+');
 }
 
-/**
+/*
  * Part of the `serializeQueryParams` helper function.
  */
 function add(s: Array<any>, k: string, v?: string | (() => string)) {

packages/adapter/addon/adapter.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/adapter
 */
 
 import EmberObject from '@ember/object';
@@ -56,7 +56,6 @@ import EmberObject from '@ember/object';
   included REST adapter.
 
   @class Adapter
-  @namespace DS
   @extends EmberObject
 */
 

packages/adapter/addon/error.js

@@ -7,6 +7,10 @@ const SOURCE_POINTER_REGEXP = /^\/?data\/(attributes|relationships)\/(.*)/;
 const SOURCE_POINTER_PRIMARY_REGEXP = /^\/?data/;
 const PRIMARY_ATTRIBUTE_KEY = 'base';
 
+/**
+  @module @ember-data/adapter
+*/
+
 /**
   A `AdapterError` is used by an adapter to signal that an error occurred
   during a request to an external API. It indicates a generic error, and

packages/adapter/addon/index.ts

@@ -1,2 +1,6 @@
+/**
+  @module @ember-data/adapter
+*/
+
 export { BuildURLMixin } from './-private';
 export { default } from './adapter';

packages/adapter/addon/json-api.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/adapter
 */
 import { dasherize } from '@ember/string';
 import RESTAdapter from './rest';
@@ -138,8 +138,7 @@ import { pluralize } from 'ember-inflector';
   @since 1.13.0
   @class JSONAPIAdapter
   @constructor
-  @namespace DS
-  @extends DS.RESTAdapter
+  @extends RESTAdapter
 */
 const JSONAPIAdapter = RESTAdapter.extend({
   defaultSerializer: '-json-api',

packages/adapter/addon/rest.js

@@ -1,6 +1,7 @@
 /* globals najax jQuery */
+
 /**
-  @module ember-data
+  @module @ember-data/adapter
 */
 
 import RSVP, { Promise as EmberPromise } from 'rsvp';
@@ -290,9 +291,8 @@ const hasNajax = typeof najax !== 'undefined';
 
   @class RESTAdapter
   @constructor
-  @namespace DS
-  @extends DS.Adapter
-  @uses DS.BuildURLMixin
+  @extends Adapter
+  @uses BuildURLMixin
 */
 const RESTAdapter = Adapter.extend(BuildURLMixin, {
   defaultSerializer: '-rest',

packages/model/addon/-private/attr.js

@@ -4,7 +4,7 @@ import { DEBUG } from '@glimmer/env';
 import { recordDataFor } from '@ember-data/store/-private';
 
 /**
-  @module ember-data
+  @module @ember-data/model
 */
 
 function getDefaultValue(record, options, key) {
@@ -101,9 +101,7 @@ function hasValue(internalModel, key) {
   })
   ```
 
-  @namespace
   @method attr
-  @for DS
   @param {String|Object} type the attribute type
   @param {Object} options a hash of options
   @return {Attribute}

packages/model/addon/-private/belongs-to.js

@@ -3,6 +3,10 @@ import { assert, warn, inspect } from '@ember/debug';
 import { normalizeModelName } from '@ember-data/store';
 import { DEBUG } from '@glimmer/env';
 
+/**
+  @module @ember-data/model
+*/
+
 /**
   `belongsTo` is used to define One-To-One and One-To-Many
   relationships on a [Model](/api/data/classes/DS.Model.html).

packages/model/addon/-private/has-many.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/model
 */
 import { computed } from '@ember/object';
 import { assert, inspect } from '@ember/debug';
@@ -136,9 +136,7 @@ import { DEBUG } from '@glimmer/env';
   If you are using `links` with sync relationships, you have to use
   `ref.reload` to fetch the resources.
 
-  @namespace
   @method hasMany
-  @for DS
   @param {String} type (optional) type of the relationship
   @param {Object} options (optional) a hash of options
   @return {Ember.computed} relationship

packages/model/addon/-private/index.ts

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/model
+*/
+
 export { default as attr } from './attr';
 export { default as belongsTo } from './belongs-to';
 export { default as hasMany } from './has-many';

packages/model/addon/index.ts

@@ -1,2 +1,6 @@
+/**
+  @module @ember-data/model
+*/
+
 export { attr, belongsTo, hasMany } from './-private';
 export { Model as default } from '@ember-data/store/-private';

packages/serializer/addon/-private/embedded-records-mixin.js

@@ -5,6 +5,10 @@ import { camelize } from '@ember/string';
 import { set, get } from '@ember/object';
 import { warn } from '@ember/debug';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /**
   ## Using Embedded Records
 
@@ -95,7 +99,6 @@ import { warn } from '@ember/debug';
   * [serializeHasMany](/api/data/classes/DS.EmbeddedRecordsMixin.html#method_serializeHasMany)
 
   @class EmbeddedRecordsMixin
-  @namespace DS
 */
 export default Mixin.create({
   /**

packages/serializer/addon/-private/index.js

@@ -1,2 +1,6 @@
+/**
+  @module @ember-data/serializer
+*/
+
 export { default as EmbeddedRecordsMixin } from './embedded-records-mixin';
 export { modelHasAttributeOrRelationshipNamedType } from './utils';

packages/serializer/addon/-private/utils.js

@@ -1,5 +1,9 @@
 import { get } from '@ember/object';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /*
   Check if the passed model has a `type` attribute or a relationship named `type`.
 

packages/serializer/addon/index.ts

@@ -1 +1,5 @@
+/**
+  @module @ember-data/serializer
+*/
+
 export { default } from './serializer';

packages/serializer/addon/json-api.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/serializer
 */
 
 import { typeOf, isNone } from '@ember/utils';

packages/serializer/addon/json.js

@@ -11,6 +11,10 @@ import { modelHasAttributeOrRelationshipNamedType } from './-private';
 import { normalizeModelName } from '@ember-data/store';
 import { coerceId } from '@ember-data/store/-private';
 
+/**
+  @module @ember-data/serializer
+*/
+
 const emberAssign = assign || merge;
 
 /**

packages/serializer/addon/rest.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/serializer
 */
 
 import { typeOf, isNone } from '@ember/utils';

packages/serializer/addon/serializer.js

@@ -1,5 +1,5 @@
 /**
-  @module ember-data
+  @module @ember-data/serializer
 */
 
 import EmberObject from '@ember/object';
@@ -20,7 +20,6 @@ import EmberObject from '@ember/object';
   [DS.JSONSerializer](DS.JSONSerializer), the included JSON serializer.
 
   @class Serializer
-  @namespace DS
   @extends EmberObject
 */
 

packages/serializer/addon/transform.js

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/serializer
+*/
+
 // TODO: @heroiceric
 // These individual transforms shouldn't be exported
 export { default as BooleanTransform } from './transforms/boolean';

packages/serializer/addon/transforms/boolean.js

@@ -1,6 +1,10 @@
 import { isNone } from '@ember/utils';
 import Transform from './transform';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /**
   The `BooleanTransform` class is used to serialize and deserialize
   boolean attributes on Ember Data record objects. This transform is

packages/serializer/addon/transforms/date.js

@@ -1,5 +1,9 @@
 import Transform from './transform';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /**
  The `DateTransform` class is used to serialize and deserialize
  date attributes on Ember Data record objects. This transform is used

packages/serializer/addon/transforms/number.js

@@ -1,5 +1,9 @@
 import Transform from './transform';
 
+/**
+  @module @ember-data/serializer
+*/
+
 function isNumber(value) {
   return value === value && value !== Infinity && value !== -Infinity;
 }

packages/serializer/addon/transforms/string.js

@@ -1,6 +1,10 @@
 import { isNone as none } from '@ember/utils';
 import Transform from './transform';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /**
   The `StringTransform` class is used to serialize and deserialize
   string attributes on Ember Data record objects. This transform is

packages/serializer/addon/transforms/transform.js

@@ -1,5 +1,9 @@
 import EmberObject from '@ember/object';
 
+/**
+  @module @ember-data/serializer
+*/
+
 /**
   The `Transform` class is used to serialize and deserialize model
   attributes when they are saved or loaded from an
@@ -69,7 +73,6 @@ import EmberObject from '@ember/object';
   ```
 
   @class Transform
-  @namespace DS
  */
 export default EmberObject.extend({
   /**

packages/store/addon/-private/index.js

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/store
+*/
+
 // // public
 export { default as Model } from './system/model/model';
 export { default as Errors } from './system/model/errors';

packages/store/addon/-private/system/backburner.js

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/store
+*/
+
 import { registerWaiter } from '@ember/test';
 import Ember from 'ember';
 import { DEBUG } from '@glimmer/env';

packages/store/addon/-private/system/clone-null.ts

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/store
+*/
+
 export default function cloneNull<T extends object>(source: T): { [K in keyof T]: T[K] } {
   let clone = Object.create(null);
   for (let key in source) {

packages/store/addon/-private/system/coerce-id.ts

@@ -1,3 +1,7 @@
+/**
+  @module @ember-data/store
+*/
+
 // Used by the store to normalize IDs entering the store.  Despite the fact
 // that developers may provide IDs as numbers (e.g., `store.findRecord('person', 1)`),
 // it is important that internally we use strings, since IDs may be serialized

packages/store/addon/-private/system/diff-array.js

@@ -1,5 +1,8 @@
+/**
+  @module @ember-data/store
+*/
+
 /*
-  @namespace
   @method diffArray
   @private
   @param {Array} oldArray the old array

packages/store/addon/-private/system/identity-map.ts

@@ -1,6 +1,10 @@
 import InternalModelMap from './internal-model-map';
 import { Dict } from '../types';
 
+/**
+  @module @ember-data/store
+*/
+
 /**
  `IdentityMap` is a custom storage map for records by modelName
  used by `Store`.