Deprecated: Type package

packages/block-editor/tsconfig.json

@@ -4,7 +4,11 @@
 		"rootDir": "src",
 		"declarationDir": "build-types"
 	},
-	"references": [ { "path": "../element" }, { "path": "../hooks" } ],
+	"references": [
+		{ "path": "../deprecated" },
+		{ "path": "../element" },
+		{ "path": "../hooks" }
+	],
 	// NOTE: This package is being progressively typed. You are encouraged to
 	// expand this array with files which can be type-checked. At some point in
 	// the future, this can be simplified to an `includes` of `src/**/*`.

packages/components/tsconfig.json

@@ -5,6 +5,7 @@
 		"declarationDir": "build-types"
 	},
 	"references": [
+		{ "path": "../deprecated" },
 		{ "path": "../element" },
 		{ "path": "../hooks" },
 		{ "path": "../primitives" }

packages/deprecated/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+### New Feature
+
+- Include TypeScript type declarations ([#26429](https://github.com/WordPress/gutenberg/pull/26429))
+
 ## 2.6.0 (2019-08-29)
 
 ### Bug Fix

packages/deprecated/README.md

@@ -54,12 +54,12 @@ deprecated( 'Eating meat', {
 _Parameters_
 
 -   _feature_ `string`: Name of the deprecated feature.
--   _options_ `?Object`: Personalisation options
--   _options.version_ `?string`: Version in which the feature will be removed.
--   _options.alternative_ `?string`: Feature to use instead
--   _options.plugin_ `?string`: Plugin name if it's a plugin feature
--   _options.link_ `?string`: Link to documentation
--   _options.hint_ `?string`: Additional message to help transition away from the deprecated feature.
+-   _options_ `[Object]`: Personalisation options
+-   _options.version_ `[string]`: Version in which the feature will be removed.
+-   _options.alternative_ `[string]`: Feature to use instead
+-   _options.plugin_ `[string]`: Plugin name if it's a plugin feature
+-   _options.link_ `[string]`: Link to documentation
+-   _options.hint_ `[string]`: Additional message to help transition away from the deprecated feature.
 
 <a name="logged" href="#logged">#</a> **logged**
 
@@ -68,7 +68,7 @@ message is only logged once.
 
 _Type_
 
--   `Object` 
+-   `Record<string,(|undefined)>` 
 
 
 <!-- END TOKEN(Autogenerated API docs) -->

packages/deprecated/package.json

@@ -21,6 +21,7 @@
 	"main": "build/index.js",
 	"module": "build-module/index.js",
 	"react-native": "src/index",
+	"types": "build-types",
 	"sideEffects": false,
 	"dependencies": {
 		"@babel/runtime": "^7.11.2",

packages/deprecated/src/index.js

@@ -7,20 +7,20 @@ import { doAction } from '@wordpress/hooks';
  * Object map tracking messages which have been logged, for use in ensuring a
  * message is only logged once.
  *
- * @type {Object}
+ * @type {Record<string,true|undefined>}
  */
 export const logged = Object.create( null );
 
 /**
  * Logs a message to notify developers about a deprecated feature.
  *
- * @param {string}  feature             Name of the deprecated feature.
- * @param {?Object} options             Personalisation options
- * @param {?string} options.version     Version in which the feature will be removed.
- * @param {?string} options.alternative Feature to use instead
- * @param {?string} options.plugin      Plugin name if it's a plugin feature
- * @param {?string} options.link        Link to documentation
- * @param {?string} options.hint        Additional message to help transition away from the deprecated feature.
+ * @param {string} feature               Name of the deprecated feature.
+ * @param {Object} [options]             Personalisation options
+ * @param {string} [options.version]     Version in which the feature will be removed.
+ * @param {string} [options.alternative] Feature to use instead
+ * @param {string} [options.plugin]      Plugin name if it's a plugin feature
+ * @param {string} [options.link]        Link to documentation
+ * @param {string} [options.hint]        Additional message to help transition away from the deprecated feature.
  *
  * @example
  * ```js

packages/deprecated/tsconfig.json

@@ -0,0 +1,9 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"rootDir": "src",
+		"declarationDir": "build-types"
+	},
+	"references": [ { "path": "../hooks" } ],
+	"include": [ "src/**/*" ]
+}

packages/eslint-plugin/configs/jsdoc.js

@@ -65,6 +65,8 @@ const typescriptUtilityTypes = [
 	'NodeJS',
 	'AsyncIterableIterator',
 	'NodeRequire',
+	'true',
+	'false',
 ];
 
 module.exports = {

tsconfig.json

@@ -6,6 +6,7 @@
 		{ "path": "packages/blob" },
 		{ "path": "packages/block-editor" },
 		{ "path": "packages/components" },
+		{ "path": "packages/deprecated" },
 		{ "path": "packages/element" },
 		{ "path": "packages/dependency-extraction-webpack-plugin" },
 		{ "path": "packages/dom-ready" },