@wordpress/core-data 4.1.0 → 4.1.2

package/src/types/menu-location.ts

@@ -0,0 +1,29 @@
+/**
+ * Internal dependencies
+ */
+import { Context, OmitNevers } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface MenuLocation< C extends Context > {
+			/**
+			 * The name of the menu location.
+			 */
+			name: string;
+			/**
+			 * The description of the menu location.
+			 */
+			description: string;
+			/**
+			 * The ID of the assigned menu.
+			 */
+			menu: number;
+		}
+	}
+}
+
+export type MenuLocation< C extends Context > = OmitNevers<
+	_BaseEntityTypes.MenuLocation< C >
+>;

package/src/types/nav-menu-item.ts

@@ -0,0 +1,106 @@
+/**
+ * Internal dependencies
+ */
+import { RenderedText, Context, ContextualField, OmitNevers } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+export type NavMenuItemType =
+	| 'taxonomy'
+	| 'post_type'
+	| 'post_type_archive'
+	| 'custom';
+export type NavMenuItemStatus =
+	| 'publish'
+	| 'future'
+	| 'draft'
+	| 'pending'
+	| 'private';
+export type Target = '_blank' | '';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface NavMenuItem< C extends Context > {
+			/**
+			 * The title for the object.
+			 */
+			title: RenderedText< C >;
+			/**
+			 * Unique identifier for the object.
+			 */
+			id: number;
+			/**
+			 * The singular label used to describe this type of menu item.
+			 */
+			type_label: string;
+			/**
+			 * The family of objects originally represented, such as "post_type" or "taxonomy".
+			 */
+			type: NavMenuItemType;
+			/**
+			 * A named status for the object.
+			 */
+			status: NavMenuItemStatus;
+			/**
+			 * The ID for the parent of the object.
+			 */
+			parent: number;
+			/**
+			 * Text for the title attribute of the link element for this menu item.
+			 */
+			attr_title: string;
+			/**
+			 * Class names for the link element of this menu item.
+			 */
+			classes: string[];
+			/**
+			 * The description of this menu item.
+			 */
+			description: string;
+			/**
+			 * The DB ID of the nav_menu_item that is this item's menu parent, if any, otherwise 0.
+			 */
+			menu_order: number;
+			/**
+			 * The type of object originally represented, such as "category", "post", or "attachment".
+			 */
+			object: string;
+			/**
+			 * The database ID of the original object this menu item represents, for example the ID for posts or the term_id for categories.
+			 */
+			object_id: number;
+			/**
+			 * The target attribute of the link element for this menu item.
+			 */
+			target: Target;
+			/**
+			 * The URL to which this menu item points.
+			 */
+			url: string;
+			/**
+			 * The XFN relationship expressed in the link of this menu item.
+			 */
+			xfn: string[];
+			/**
+			 * Whether the menu item represents an object that no longer exists.
+			 */
+			invalid: boolean;
+			/**
+			 * The terms assigned to the object in the nav_menu taxonomy.
+			 */
+			menus: ContextualField< number, 'view' | 'edit', C >;
+			/**
+			 * Meta fields.
+			 */
+			meta: ContextualField<
+				Record< string, string >,
+				'view' | 'edit',
+				C
+			>;
+		}
+	}
+}
+
+export type NavMenuItem< C extends Context > = OmitNevers<
+	_BaseEntityTypes.NavMenuItem< C >
+>;

package/src/types/nav-menu.ts

@@ -0,0 +1,53 @@
+/**
+ * Internal dependencies
+ */
+import { Context, ContextualField, OmitNevers } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface NavMenu< C extends Context > {
+			/**
+			 * Unique identifier for the term.
+			 */
+			id: number;
+			/**
+			 * HTML description of the term.
+			 */
+			description: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * HTML title for the term.
+			 */
+			name: string;
+			/**
+			 * An alphanumeric identifier for the term unique to its type.
+			 */
+			slug: string;
+			/**
+			 * Meta fields.
+			 */
+			meta: ContextualField<
+				Record< string, string >,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * The locations assigned to the menu.
+			 */
+			locations: ContextualField< string[], 'view' | 'edit', C >;
+			/**
+			 * The DB ID of the original object this menu item represents, e . g . ID for posts and term_id for categories.
+			 */
+			object_id: number;
+			/**
+			 * Whether to automatically add top level pages to this menu.
+			 */
+			auto_add: ContextualField< boolean, 'view' | 'edit', C >;
+		}
+	}
+}
+
+export type NavMenu< C extends Context > = OmitNevers<
+	_BaseEntityTypes.NavMenu< C >
+>;

package/src/types/navigation-area.ts

@@ -0,0 +1,29 @@
+/**
+ * Internal dependencies
+ */
+import { Context, OmitNevers } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface NavigationArea< C extends Context > {
+			/**
+			 * The name of the navigation area.
+			 */
+			name: string;
+			/**
+			 * The description of the navigation area.
+			 */
+			description: string;
+			/**
+			 * The ID of the assigned navigation.
+			 */
+			navigation: number;
+		}
+	}
+}
+
+export type NavigationArea< C extends Context > = OmitNevers<
+	_BaseEntityTypes.NavigationArea< C >
+>;

package/src/types/page.ts

@@ -0,0 +1,144 @@
+/**
+ * Internal dependencies
+ */
+import {
+	CommentingStatus,
+	Context,
+	ContextualField,
+	PingStatus,
+	PostStatus,
+	RenderedText,
+	OmitNevers,
+} from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface Page< C extends Context > {
+			/**
+			 * The date the post was published, in the site's timezone.
+			 */
+			date: string | null;
+			/**
+			 * The date the post was published, as GMT.
+			 */
+			date_gmt: ContextualField< string | null, 'view' | 'edit', C >;
+			/**
+			 * The globally unique identifier for the post.
+			 */
+			guid: ContextualField< RenderedText< C >, 'view' | 'edit', C >;
+			/**
+			 * Unique identifier for the post.
+			 */
+			id: number;
+			/**
+			 * URL to the post.
+			 */
+			link: string;
+			/**
+			 * The date the post was last modified, in the site's timezone.
+			 */
+			modified: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * The date the post was last modified, as GMT.
+			 */
+			modified_gmt: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * An alphanumeric identifier for the post unique to its type.
+			 */
+			slug: string;
+			/**
+			 * A named status for the post.
+			 */
+			status: ContextualField< PostStatus, 'view' | 'edit', C >;
+			/**
+			 * Type of post.
+			 */
+			type: string;
+			/**
+			 * A password to protect access to the content and excerpt.
+			 */
+			password: ContextualField< string, 'edit', C >;
+			/**
+			 * Permalink template for the post.
+			 */
+			permalink_template: ContextualField< string, 'edit', C >;
+			/**
+			 * Slug automatically generated from the post title.
+			 */
+			generated_slug: ContextualField< string, 'edit', C >;
+			/**
+			 * The ID for the parent of the post.
+			 */
+			parent: ContextualField< number, 'view' | 'edit', C >;
+			/**
+			 * The title for the post.
+			 */
+			title: RenderedText< C >;
+			/**
+			 * The content for the post.
+			 */
+			content: ContextualField<
+				RenderedText< C > & {
+					/**
+					 * Whether the content is protected with a password.
+					 */
+					is_protected: boolean;
+					/**
+					 * Version of the content block format used by the page.
+					 */
+					block_version: ContextualField< string, 'edit', C >;
+				},
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * The ID for the author of the post.
+			 */
+			author: number;
+			/**
+			 * The excerpt for the post.
+			 */
+			excerpt: RenderedText< C > & {
+				protected: boolean;
+			};
+			/**
+			 * The ID of the featured media for the post.
+			 */
+			featured_media: number;
+			/**
+			 * Whether or not comments are open on the post.
+			 */
+			comment_status: ContextualField<
+				CommentingStatus,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * Whether or not the post can be pinged.
+			 */
+			ping_status: ContextualField< PingStatus, 'view' | 'edit', C >;
+			/**
+			 * The order of the post in relation to other posts.
+			 */
+			menu_order: ContextualField< number, 'view' | 'edit', C >;
+			/**
+			 * Meta fields.
+			 */
+			meta: ContextualField<
+				Record< string, string >,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * The theme file to use to display the post.
+			 */
+			template: ContextualField< string, 'view' | 'edit', C >;
+		}
+	}
+}
+
+export type Page< C extends Context > = OmitNevers<
+	_BaseEntityTypes.Page< C >
+>;

package/src/types/plugin.ts

@@ -0,0 +1,74 @@
+/**
+ * Internal dependencies
+ */
+import { Context, ContextualField, RenderedText, OmitNevers } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface Plugin< C extends Context > {
+			/**
+			 * The plugin file.
+			 */
+			plugin: string;
+			/**
+			 * The plugin activation status.
+			 */
+			status: PluginStatus;
+			/**
+			 * The plugin name.
+			 */
+			name: string;
+			/**
+			 * The plugin's website address.
+			 */
+			plugin_uri: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * The plugin author.
+			 */
+			author: ContextualField<
+				Record< string, string >,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * Plugin author's website address.
+			 */
+			author_uri: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * The plugin description.
+			 */
+			description: ContextualField<
+				RenderedText< 'edit' >,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * The plugin version number.
+			 */
+			version: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * Whether the plugin can only be activated network-wide.
+			 */
+			network_only: boolean;
+			/**
+			 * Minimum required version of WordPress.
+			 */
+			requires_wp: string;
+			/**
+			 * Minimum required version of PHP.
+			 */
+			requires_php: string;
+			/**
+			 * The plugin's text domain.
+			 */
+			textdomain: ContextualField< string, 'view' | 'edit', C >;
+		}
+	}
+}
+
+export type PluginStatus = 'active' | 'inactive';
+export type Plugin< C extends Context > = OmitNevers<
+	_BaseEntityTypes.Plugin< C >
+>;

package/src/types/post.ts

@@ -0,0 +1,153 @@
+/**
+ * Internal dependencies
+ */
+import {
+	CommentingStatus,
+	Context,
+	ContextualField,
+	PingStatus,
+	PostFormat,
+	PostStatus,
+	RenderedText,
+	OmitNevers,
+} from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface Post< C extends Context > {
+			/**
+			 * The date the post was published, in the site's timezone.
+			 */
+			date: string | null;
+			/**
+			 * The date the post was published, as GMT.
+			 */
+			date_gmt: ContextualField< string | null, 'view' | 'edit', C >;
+			/**
+			 * The globally unique identifier for the post.
+			 */
+			guid: ContextualField< RenderedText< C >, 'view' | 'edit', C >;
+			/**
+			 * Unique identifier for the post.
+			 */
+			id: number;
+			/**
+			 * URL to the post.
+			 */
+			link: string;
+			/**
+			 * The date the post was last modified, in the site's timezone.
+			 */
+			modified: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * The date the post was last modified, as GMT.
+			 */
+			modified_gmt: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * An alphanumeric identifier for the post unique to its type.
+			 */
+			slug: string;
+			/**
+			 * A named status for the post.
+			 */
+			status: ContextualField< PostStatus, 'view' | 'edit', C >;
+			/**
+			 * Type of post.
+			 */
+			type: string;
+			/**
+			 * A password to protect access to the content and excerpt.
+			 */
+			password: ContextualField< string, 'edit', C >;
+			/**
+			 * Permalink template for the post.
+			 */
+			permalink_template: ContextualField< string, 'edit', C >;
+			/**
+			 * Slug automatically generated from the post title.
+			 */
+			generated_slug: ContextualField< string, 'edit', C >;
+			/**
+			 * The title for the post.
+			 */
+			title: RenderedText< C >;
+			/**
+			 * The content for the post.
+			 */
+			content: ContextualField<
+				RenderedText< C > & {
+					/**
+					 * Whether the content is protected with a password.
+					 */
+					is_protected: boolean;
+					/**
+					 * Version of the content block format used by the page.
+					 */
+					block_version: ContextualField< string, 'edit', C >;
+				},
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * The ID for the author of the post.
+			 */
+			author: number;
+			/**
+			 * The excerpt for the post.
+			 */
+			excerpt: RenderedText< C > & {
+				protected: boolean;
+			};
+			/**
+			 * The ID of the featured media for the post.
+			 */
+			featured_media: number;
+			/**
+			 * Whether or not comments are open on the post.
+			 */
+			comment_status: ContextualField<
+				CommentingStatus,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * Whether or not the post can be pinged.
+			 */
+			ping_status: ContextualField< PingStatus, 'view' | 'edit', C >;
+			/**
+			 * The format for the post.
+			 */
+			format: ContextualField< PostFormat, 'view' | 'edit', C >;
+			/**
+			 * Meta fields.
+			 */
+			meta: ContextualField<
+				Record< string, string >,
+				'view' | 'edit',
+				C
+			>;
+			/**
+			 * Whether or not the post should be treated as sticky.
+			 */
+			sticky: ContextualField< boolean, 'view' | 'edit', C >;
+			/**
+			 * The theme file to use to display the post.
+			 */
+			template: ContextualField< string, 'view' | 'edit', C >;
+			/**
+			 * The terms assigned to the post in the category taxonomy.
+			 */
+			categories: ContextualField< number[], 'view' | 'edit', C >;
+			/**
+			 * The terms assigned to the post in the post_tag taxonomy.
+			 */
+			tags: ContextualField< number[], 'view' | 'edit', C >;
+		}
+	}
+}
+
+export type Post< C extends Context > = OmitNevers<
+	_BaseEntityTypes.Post< C >
+>;

package/src/types/settings.ts

@@ -0,0 +1,93 @@
+/**
+ * Internal dependencies
+ */
+import { CommentingStatus, Context, OmitNevers, PingStatus } from './helpers';
+
+import { BaseEntityTypes as _BaseEntityTypes } from './base-entity-types';
+
+declare module './base-entity-types' {
+	export namespace BaseEntityTypes {
+		export interface Settings< C extends Context > {
+			/**
+			 * What to show on the front page
+			 */
+			show_on_front: string;
+			/**
+			 * The ID of the page that should be displayed on the front page
+			 */
+			page_on_front: number;
+			/**
+			 * Site title.
+			 */
+			title: string;
+			/**
+			 * Site tagline.
+			 */
+			description: string;
+			/**
+			 * Site URL.
+			 */
+			url: string;
+			/**
+			 * This address is used for admin purposes, like new user notification.
+			 */
+			email: string;
+			/**
+			 * A city in the same timezone as you.
+			 */
+			timezone: string;
+			/**
+			 * A date format for all date strings.
+			 */
+			date_format: string;
+			/**
+			 * A time format for all time strings.
+			 */
+			time_format: string;
+			/**
+			 * A day number of the week that the week should start on.
+			 */
+			start_of_week: number;
+			/**
+			 * WordPress locale code.
+			 */
+			language: string;
+			/**
+			 * Convert emoticons like :-) and :-P to graphics on display.
+			 */
+			use_smilies: boolean;
+			/**
+			 * Default post category.
+			 */
+			default_category: number;
+			/**
+			 * Default post format.
+			 */
+			default_post_format: string;
+			/**
+			 * Blog pages show at most.
+			 */
+			posts_per_page: number;
+			/**
+			 * Allow link notifications from other blogs (pingbacks and trackbacks) on new articles.
+			 */
+			default_ping_status: PingStatus;
+			/**
+			 * Allow people to submit comments on new posts.
+			 */
+			default_comment_status: CommentingStatus;
+			/**
+			 * Site logo.
+			 */
+			site_logo: number;
+			/**
+			 * Site icon.
+			 */
+			site_icon: number;
+		}
+	}
+}
+
+export type Settings< C extends Context > = OmitNevers<
+	_BaseEntityTypes.Settings< C >
+>;