await ( await import( '@wordpress/core-abilities' ) ).ready;
const { executeAbility } = await import( '@wordpress/abilities' );

const tag = await executeAbility( 'core/term-create', { taxonomy: 'post_tag', name: 'Green', description: 'Like <em>grass</em>.' } );
// { id: 28556, count: 0, name: 'Green', slug: 'green', taxonomy: 'post_tag' }

// The ID is always included.
const citrus = await executeAbility( 'core/term-create', { taxonomy: 'category', name: 'Citrus', parent: 28554, fields: [ 'name', 'slug', 'parent', 'link' ] } );
// { id: 28557, link: 'http://localhost:8896/?cat=28557', name: 'Citrus', slug: 'citrus', parent: 28554 }

// The name is taken under that parent.
await executeAbility( 'core/term-create', { taxonomy: 'category', name: 'Citrus', parent: 28554 } );
// Rejects with { code: 'term_exists', message: 'A term with the name provided already exists with this parent.', data: { status: 400, term_id: 28557 } }

// Renaming keeps the slug.
await executeAbility( 'core/term-update', { id: tag.id, name: 'Lime green', fields: [ 'name', 'slug', 'description' ] } );
// { id: 28556, description: 'Like <em>grass</em>.', name: 'Lime green', slug: 'green' }

await executeAbility( 'core/term-update', { id: citrus.id, parent: 0, fields: [ 'name', 'parent' ] } );
// { id: 28557, name: 'Citrus', parent: 0 }

// `taxonomy` is an optional guard: a term outside it is denied like a missing one.
await executeAbility( 'core/term-update', { id: citrus.id, taxonomy: 'post_tag', name: 'Lemon' } );
// Rejects with { code: 'rest_ability_cannot_execute', message: 'Sorry, you are not allowed to execute this ability.', data: { status: 403 } }

// Tags aren't hierarchical.
await executeAbility( 'core/term-update', { id: tag.id, parent: 28554 } );
// Rejects with { code: 'terms_taxonomy_not_hierarchical', message: 'Cannot set parent term, taxonomy is not hierarchical.', data: { status: 400 } }

// Terms can't be trashed, so `force` must be true.
await executeAbility( 'core/term-delete', { id: tag.id } );
// Rejects with { code: 'terms_trash_not_supported', message: 'Terms do not support trashing. Set `force` to true to delete.', data: { status: 501 } }

await executeAbility( 'core/term-delete', { id: tag.id, force: true, fields: [ 'name', 'slug' ] } );
// { deleted: true, previous: { id: 28556, name: 'Lime green', slug: 'green' } }

await executeAbility( 'core/term-delete', { id: citrus.id, taxonomy: 'category', force: true } );
// { deleted: true, previous: { id: 28557, count: 0, name: 'Citrus', slug: 'citrus', taxonomy: 'category', parent: 0 } }

// A deleted term can't be read, and the default category can't be deleted.
await executeAbility( 'core/terms-query', { id: tag.id } );
await executeAbility( 'core/term-delete', { id: 1, force: true } );
// Both reject with { code: 'rest_ability_cannot_execute', message: 'Sorry, you are not allowed to execute this ability.', data: { status: 403 } }

// The client rejects these before sending a request.
await executeAbility( 'core/term-create', { taxonomy: 'nav_menu', name: 'Menu' } );
// Rejects with { code: 'ability_invalid_input', message: 'Ability "core/term-create" has invalid input. Reason: input[taxonomy] is not one of category, post_tag.' }

await executeAbility( 'core/term-create', { taxonomy: 'post_tag', name: 'Blue', meta: {} } );
// Rejects with { code: 'ability_invalid_input', message: 'Ability "core/term-create" has invalid input. Reason: meta is not a valid property of Object.' }