fix(entities-*): revamp hide toolbar logic

[Justineo]

Summary

KM-709

Preview PR for konnect-ui-apps: https://github.com/Kong/konnect-ui-apps/pull/4896

Note

I've updated this PR to a more comprehensive fix for several current issues.

Currently, logic related to table state and toolbar visibility is scattered across multiple places, leading to redundancy, inaccuracies, and visual inconsistencies. Here's a breakdown of the existing problems and their respective issues:

1. Each entity list observes fetcherState to update a hasData flag, which determines the visibility of the create button:

   public-ui-components/packages/entities/entities-gateway-services/src/components/GatewayServiceList.vue

   Lines 562 to 565 in 1ea901e

   	// reset `hasData` to show/hide the teleported Create button
   	if (Array.isArray(state?.response?.data)) {
   	hasData.value = state.response!.data.length > 0
   	}

   Problem: It does not account for cache states in KTableData, causing layout shifts during revalidation.

2. Each entity list observes fetcherState to toggle the hideTableToolbar flag and set it to true when the state is FetcherStatus.NoRecords:

   public-ui-components/packages/entities/entities-gateway-services/src/components/GatewayServiceList.vue

   Lines 567 to 571 in 1ea901e

   	if (state.status === FetcherStatus.NoRecords) {
   	hideTableToolbar.value = true
   	} else {
   	hideTableToolbar.value = false
   	}

   Problem: Similar cache-awareness issues result in layout shifts when navigating away and returning to the list.

3. EntityBaseTable also controls the visibility of toolbar content using the KTableData's state event:

   public-ui-components/packages/entities/entities-shared/src/components/entity-base-table/EntityBaseTable.vue

   Lines 264 to 266 in 1ea901e

   	const showToolbar = (state: SwrvStateData): boolean => {
   	return state.hasData || !!props.query
   	}

   Problem: Toolbar visibility and its content can desynchronize (e.g., filter inputs hidden but the toolbar remains visible).

Refactored Logic

To address these issues, all related logic has been centralized within the EntityBaseTable, ensuring consistent behavior across all use cases. The refactored workflow includes:

1. We no longer show/hide create button or toolbar content separate to the toolbar itself
2. The toolbar is hidden if nothing has been added to the table (initial state)
3. KTableData's hideToolbar is now calculated by table states and query
4. If a filter query exists, the toolbar remains visible regardless of the table state (e.g., no records or no filter results)
5. If the table has previously contained data (even if none is visible now due to clearing a query), the toolbar will remain visible as we are confident that we'll see unfiltered records
6. Toolbar visibility remains configurable through the current hideToolbar prop, which now defaults to undefined so that we can offer the default behavior if it's not specified

[2eha0]

LGTM

[nekolab]

LGTM

[kaiarrowood]

This looks good to me, awesome work @Justineo

[portikM]

LGTM 🚀