@jskit-ai/agent-docs 0.1.102 → 0.1.103

package/guide/agent/generators/crud-generators.md

@@ -444,6 +444,31 @@ That creates the baseline CRUD route tree:
 - `w/[workspaceSlug]/admin/contacts/[contactId]/edit.vue`
 - shared `_components` files under the same route root
 
+Generated list, view, and lookup reads use the resource contract as their
+response authority. They return every field declared for output by default,
+including the target resource's declared output when a lookup relation is
+hydrated; generated pages do not repeat those fields in a second page-owned
+allowlist. Adding an output field or lookup to the resource therefore does not
+require regenerating endpoint projections.
+
+Put exceptional large fields in the resource-owned default response blacklist,
+`resource.contract.response.defaultExclude`:
+
+```js
+contract: {
+  response: {
+    defaultExclude: ["rawPayload", "largeAuditJson"]
+  }
+}
+```
+
+Each included resource applies its own blacklist. A default-excluded field is
+still part of the public output contract and can be requested through an
+explicit typed JSON:API `fields[type]` fieldset. Use that sparse-field override
+only for a specialised caller; do not add one to ordinary generated pages or
+build a page-local query-string adapter. Fields that must never be exposed do
+not belong in the output schema at all.
+
 This is the most important mental model in the whole chapter:
 
 - `crud-server-generator` creates the reusable CRUD contract and server package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/agent-docs",
-  "version": "0.1.102",
+  "version": "0.1.103",
   "description": "Distributed JSKIT agent references, prompts, guides, and generated reference maps.",
   "type": "module",
   "files": [

package/patterns/client-requests.md

@@ -49,6 +49,7 @@ Generated screen wrapper extension rules:
 - Use `useCrudListScreen({ readEnabled })` for permission-gated generated list reads instead of splitting the page or replacing the shared list screen.
 - Use `useCrudListScreen({ requestQueryParams })` for list includes or other endpoint query params instead of putting query strings in `apiSuffix`.
 - Use `useCrudViewScreen({ requestQueryParams })` for detail includes instead of putting query strings in `apiUrlTemplate`.
+- Use `requestFieldsets` only when a specialised caller intentionally needs a typed JSON:API sparse fieldset. Ordinary generated reads use the complete resource output contract.
 - Use `readEnabled` and `queryKeyFactory` on `useCrudViewScreen()` when the detail read needs the same gating or cache identity control as `useCrudView()`.
 - Use `CrudViewScreen` slots (`before-fields`, `fields`, `after-fields`, `supporting-content`) for page-specific domain sections while keeping shared load/error/retry chrome.
 - Use `listRowActions` with `defineCrudListRowActions(...)` for row-level commands in `CrudListScreen`.
@@ -72,6 +73,11 @@ Why this is the standard JSKIT shape:
 - `usersWebHttpClient` already handles credentials and CSRF behavior.
 - `useEndpointResource()` is the shared endpoint primitive for loading, saving, and standard load/save error handling. Higher-level runtimes add UI feedback and field-error handling on top.
 - Use `requestQueryParams` for endpoint query strings on list, view, and add/edit runtimes.
+- Generated CRUD and lookup reads use all resource-defined output fields by default. Hydrated relationships use the target resource's output contract. Generated pages and lookup controls do not repeat those definitions as request fieldsets.
+- Put exceptional large fields in `resource.contract.response.defaultExclude`. The target resource owns that default even when it is included by another resource.
+- `requestFieldsets` remains an explicit specialised override and accepts the canonical typed shape, for example `{ jobs: ["id", "status"], contacts: ["id", "displayName"] }`. It participates in both the request and the query cache key.
+- Sparse fieldsets are a serialization boundary, not an authorization mechanism. Server resources reject unknown fields, never serialize hidden fields, and preserve the fields needed internally for relationship linkage.
+- Fields that must never be exposed do not belong in the resource output schema.
 - Keep `apiUrlTemplate` path-only. Do not put `?include=...` or other query strings in URL templates.
 - If an app needs route-aware API URL rewriting, configure the users-web client once with `configureUsersWebHttpClient({ resolveRequestUrl })` before mounting the app. Do not replace `fetchImpl` just to rewrite paths.
 - `resolveRequestUrl` belongs at the HTTP client boundary. It runs after JSKIT encodes query params and before browser `fetch`, so reads, commands, request recovery metadata, JSON:API transport, credentials, and CSRF behavior stay on the standard path.
@@ -96,6 +102,8 @@ Avoid:
 - manually concatenating scoped route params into API URLs
 - using a lower-level seam when a higher-level routed CRUD or command runtime already fits
 - smuggling query params into `apiUrlTemplate`
+- hand-building `fields[type]` parameters or page-local sparse-response adapters
+- repeating resource output fields as page-owned request allowlists
 - replacing `CrudListScreen` or `CrudViewScreen` only to add read gating, row actions, synthetic display rows, includes, or domain detail sections
 - reporting routine resource load errors through hand-written global snackbar/banner calls
 - calling `useShellRequestRecoveryRuntime().report(...)` from normal panels just to recover an HTTP read

package/patterns/filters.md

@@ -13,6 +13,7 @@ Ask first:
 - which fields are filterable
 - whether each filter is a flag, enum, multi-enum, date/date-range, number-range, record id, or lookup-backed record id
 - whether filters must sync to the route query
+- whether a filter needs a default before the first request
 - whether the screen needs chips and clear/reset behavior
 - whether lookup filters need remote autocomplete search
 - whether there are presets such as "Today", "Last 7 Days", or "Only Archived"
@@ -25,6 +26,27 @@ Default JSKIT client pattern:
 5. The AI/app author is responsible for ensuring the server accepts and applies the query params declared in `listFilters.js`.
 6. For lookup-backed filters, use `useCrudListFilterLookups(...)` when the page needs remote options or readable chip labels.
 
+Initial-value contract:
+- declare a pre-query default with `defaultValue` in the filter definition
+- a valid route-query value wins over `defaultValue`
+- when the initial route has no value, `defaultValue` is applied before list reading is enabled
+- an invalid initial route value falls back to `defaultValue`
+- clearing a filter after initialization produces the empty value; it does not reapply the default
+- route back/forward navigation rehydrates the same filter state without an early unfiltered request
+
+```js
+const listFilters = defineCrudListFilters({
+  currentness: {
+    type: "enum",
+    defaultValue: "active",
+    options: [
+      { value: "active", label: "Active" },
+      { value: "archived", label: "Archived" }
+    ]
+  }
+});
+```
+
 Generated client shape:
 - `src/pages/<surface>/<resource>/listFilters.js`
 - `const listFilters = defineCrudListFilters({ ... })`
@@ -94,6 +116,7 @@ Avoid:
 - editing generated `.vue` files just to add basic filter controls; use the page-local `listFilters.js` seam first
 - overloading `q` with structured filter meaning
 - inline filter-definition objects passed into `useCrudListFilters(...)`, `createCrudListFilters(...)`, or `createCrudListFilterContract(...)`; keep definitions in a named module
+- assigning a default to `filterRuntime.values` after `useCrudListScreen(...)` has started; that changes the query after construction and can issue a second initial request
 
 Good shape:
 - `src/pages/home/customers/listFilters.js`
@@ -117,5 +140,6 @@ Review checks:
 - one filter definition source of truth: generated page-local `listFilters.js` for client-only filters, or a shared CRUD-package module when server code imports the same definitions
 - server validator, JSON REST search schema, and repository query projection derived from that source through `createCrudListFilterContract(...)`
 - client query params/chips/reset logic derived from that source
+- initial route/default resolution completes before the first list request
 - lookup-backed filters use the shared lookup helper, not a page-local mini-framework
 - the two-phase server exception is intentional and documented, not accidental drift

package/reference/autogen/KERNEL_MAP.md

@@ -64,6 +64,7 @@ Exports
 - `parseCrudListRangeQueryExpression(value = null)`
 - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
 - `defineCrudListFilters(definitions = {})`
+- `createCrudListFilterEmptyValue(filter = {})`
 - `createCrudListFilterInitialValue(filter = {})`
 - `isCrudListFilterMultiValue(filter = {})`
 - `isCrudListFilterStructuredValue(filter = {})`
@@ -171,6 +172,12 @@ Exports
 - `shouldRetryTransientQueryFailure`
 - `transientQueryRetryDelay`
 
+### `support/jsonApiFieldsets.js`
+Exports
+- `normalizeJsonApiFieldList(value = [])`
+- `normalizeJsonApiFieldsets(value = {}, { primaryType = "" } = {})`
+- `buildJsonApiFieldsetsToken(value = {})`
+
 ### `support/linkPath.js`
 Exports
 - `isExternalLinkTarget(target = "")`

package/reference/autogen/packages/crud-core.md

@@ -165,6 +165,7 @@ Exports
 - `createCrudCursorPaginationQueryValidator(list = {})`
 - `listSearchQueryValidator`
 - `lookupIncludeQueryValidator`
+- `jsonApiFieldsetsQueryValidator`
 - `resolveCrudParentFilterKeys(resource = {})`
 - `createCrudParentFilterQueryValidator(resource = {})`
 Local functions

package/reference/autogen/packages/http-runtime.md

@@ -247,6 +247,9 @@ Local functions
 - `isRecord(value)`
 - `normalizeQueryKey(key = "")`
 - `buildFieldsTransportKey(responseType = "")`
+- `parseFieldsTransportType(key = "")`
+- `addJsonApiFieldset(fieldsets, type = "", value = [])`
+- `createJsonApiFieldsTransportValueSchema()`
 - `normalizeTransportQueryScalar(value)`
 
 ### `src/shared/validators/jsonApiResponses.js`
@@ -272,18 +275,18 @@ Local functions
 ### `src/shared/validators/jsonApiRouteTransport.js`
 Exports
 - `JSON_API_ERROR_DOCUMENT_SCHEMA`
-- `createJsonApiResourceObjectTransportSchema({ type = "", attributes, requireId = true, includeLinks = false, includeMeta = false, excludeAttributeKeys = [], relationshipEntries = [], relationshipMembersRequired = false } = {})`
+- `createJsonApiResourceObjectTransportSchema({ type = "", attributes, requireId = true, includeLinks = false, includeMeta = false, excludeAttributeKeys = [], relationshipEntries = [], relationshipMembersRequired = false, allowSparseFields = false } = {})`
 - `createJsonApiResourceRequestBodyTransportSchema({ type = "", attributes, requireId = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
-- `createJsonApiResourceSuccessTransportSchema({ type = "", attributes, kind = "record", includeLinks = false, includeMeta = false, includeIncluded = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
+- `createJsonApiResourceSuccessTransportSchema({ type = "", attributes, kind = "record", includeLinks = false, includeMeta = false, includeIncluded = false, allowSparseFields = false, excludeAttributeKeys = [], relationshipEntries = [] } = {})`
 - `withJsonApiErrorResponses(successResponses, { includeValidation400 = false } = {})`
 - `createJsonApiResourceRouteTransport({ type = "", requestType = "", responseType = "", query = null, allowBodyId = false, successKind = "record", pointerPrefix = "/data/attributes", mapRequestRelationships = null, getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null } = {})`
-- `createJsonApiResourceRouteContract({ type = "", requestType = "", responseType = "", body = null, query = null, output = null, outputKind = "record", successStatus = 200, includeValidation400 = false, allowBodyId = false, pointerPrefix = "/data/attributes", bodyAttributeExcludeKeys = [], outputAttributeExcludeKeys = [], bodyRelationshipEntries = [], outputRelationshipEntries = [], getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null, mapRequestRelationships = null } = {})`
+- `createJsonApiResourceRouteContract({ type = "", requestType = "", responseType = "", body = null, query = null, output = null, outputKind = "record", successStatus = 200, includeValidation400 = false, allowSparseFields = false, allowBodyId = false, pointerPrefix = "/data/attributes", bodyAttributeExcludeKeys = [], outputAttributeExcludeKeys = [], bodyRelationshipEntries = [], outputRelationshipEntries = [], getRecordType = null, getRecordId = null, getRecordAttributes = null, getRecordRelationships = null, getRecordLinks = null, getRecordMeta = null, getIncluded = null, getDocumentLinks = null, getDocumentMeta = null, getCollectionItems = null, mapRequestRelationships = null } = {})`
 Local functions
 - `isRecord(value)`
 - `createJsonApiTransportError(statusCode, message, code)`
 - `resolveRouteType(type = "")`
 - `resolveRouteTypes(value = {})`
-- `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [] } = {})`
+- `resolveEmbeddedAttributesTransportSchema(definition, { context = "JSON:API resource", defaultMode = "replace", removeId = false, removeKeys = [], allowSparseFields = false } = {})`
 - `normalizeRelationshipSchemaEntries(entries = [])`
 - `createJsonApiRelationshipDataSchema(relationshipType = "", { many = false, nullable = false } = {})`
 - `createJsonApiRelationshipsTransportSchema(entries = [], { includeRequired = false } = {})`

package/reference/autogen/packages/json-rest-api-core.md

@@ -31,6 +31,7 @@ Exports
 - `extractJsonRestCollectionRows(payload = null)`
 - `isJsonRestResourceMissingError(error = null)`
 - `returnNullWhenJsonRestResourceMissing(run)`
+- `returnBadRequestWhenJsonRestFieldsetInvalid(run)`
 - `resolveWorkspaceScopeValue(context = null)`
 - `resolveUserScopeValue(context = null)`
 - `createJsonRestApiHost({ knex })`
@@ -47,7 +48,10 @@ Local functions
 - `normalizeJsonRestQueryField(fieldName = "", fieldDefinition = {}, projectionDefinition = null)`
 - `isJsonRestVirtualField(fieldDefinition = null)`
 - `applyJsonRestQueryFields(scopeOptions = {}, extraQueryFields = {})`
+- `resolveJsonRestDefaultExcludedFields(resource = {})`
+- `applyJsonRestDefaultExclusions(scopeOptions = {}, resource = {})`
 - `extractJsonApiInputRelationships(attributes = {}, resource = null, relationships = null)`
+- `isJsonRestSparseFieldError(error = null)`
 
 ### root
 

package/reference/autogen/packages/kernel.md

@@ -229,6 +229,7 @@ Exports
 - `parseCrudListRangeQueryExpression(value = null)`
 - `formatCrudListRangeQueryExpression(startValue = "", endValue = "", { collapseExact = false } = {})`
 - `defineCrudListFilters(definitions = {})`
+- `createCrudListFilterEmptyValue(filter = {})`
 - `createCrudListFilterInitialValue(filter = {})`
 - `isCrudListFilterMultiValue(filter = {})`
 - `isCrudListFilterStructuredValue(filter = {})`
@@ -336,6 +337,12 @@ Exports
 - `shouldRetryTransientQueryFailure`
 - `transientQueryRetryDelay`
 
+### `shared/support/jsonApiFieldsets.js`
+Exports
+- `normalizeJsonApiFieldList(value = [])`
+- `normalizeJsonApiFieldsets(value = {}, { primaryType = "" } = {})`
+- `buildJsonApiFieldsetsToken(value = {})`
+
 ### `shared/support/linkPath.js`
 Exports
 - `isExternalLinkTarget(target = "")`

package/reference/autogen/packages/users-web.md

@@ -259,11 +259,11 @@ Exports
 
 ### `src/client/composables/records/useList.js`
 Exports
-- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "users-web.list", fallbackLoadError = "Unable to load list.", initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = "List", realtime = null, adapter = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, requestQueryParams = null, syncToRoute = false } = {})`
+- `useList({ ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readEnabled = true, placementSource = "users-web.list", fallbackLoadError = "Unable to load list.", initialPageParam = null, getNextPageParam, selectItems, client = null, transport = null, requestOptions, queryOptions, requestRecovery, requestRecoveryLabel = "List", realtime = null, adapter = null, recordIdParam = "recordId", recordIdSelector = null, viewUrlTemplate = "", editUrlTemplate = "", search = null, queryParams = null, routeQueryValueResolvers = null, requestQueryParams = null, requestFieldsets = null, syncToRoute = false } = {})`
 
 ### `src/client/composables/records/useView.js`
 Exports
-- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "users-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, requestQueryParams = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined, adapter = null } = {})`
+- `useView({ resource = null, ownershipFilter = ROUTE_VISIBILITY_WORKSPACE, surfaceId = "", access = "auto", apiSuffix = "", queryKeyFactory = null, viewPermissions = [], readMethod = "GET", readEnabled = true, client = null, transport = null, requestRecovery = null, requestRecoveryLabel = "Resource", placementSource = "users-web.view", fallbackLoadError = "Unable to load resource.", notFoundStatuses = [404], notFoundMessage = "Record not found.", model, mapLoadedToModel, requestQueryParams = null, requestFieldsets = null, recordIdParam = "recordId", routeParams = null, routeRecordId = null, apiUrlTemplate = "", listUrlTemplate = "", editUrlTemplate = "", includeRecordIdInQueryKey = false, realtime = undefined, adapter = null } = {})`
 
 ### `src/client/composables/runtime/addEditUiRuntime.js`
 Exports
@@ -360,11 +360,11 @@ Local functions
 ### `src/client/composables/support/listQueryParamSupport.js`
 Exports
 - `normalizeListSyncToRouteConfig(syncToRoute = false, { defaultSearchParam = "q" } = {})`
-- `resolveQueryParamDescriptors(queryParams, context = {})`
+- `resolveQueryParamDescriptors(queryParams, context = {}, { routeValueResolvers = null } = {})`
 - `resolveActiveQueryParamEntries(descriptors = [])`
 - `resolveWritableQueryParamBindings(descriptors = [])`
 - `buildQueryParamEntriesToken(entries = [])`
-- `parseRouteBindingValue(binding, routeQueryValue)`
+- `parseRouteBindingValue(binding, routeQueryValue, context = {})`
 - `areQueryParamBindingValuesEqual(left, right)`
 - `buildRouteQueryCompareToken(query = {})`
 - `mergeManagedQueryParamKeyHistory(history = [], keys = [])`
@@ -375,7 +375,7 @@ Local functions
 - `resolveQueryParamsInput(queryParams, context = {})`
 - `resolveQueryParamBindingType(value)`
 - `resolveArrayQueryParamItemType(values = [])`
-- `createWritableQueryParamBinding({ source = {}, rawKey = "", rawValue = null, key = "" } = {})`
+- `createWritableQueryParamBinding({ source = {}, rawKey = "", rawValue = null, key = "", resolveRouteValue = null } = {})`
 - `firstRouteQueryValue(value)`
 - `normalizeRouteQueryValues(value)`
 - `parseRouteBooleanValue(value, fallback = false)`
@@ -398,11 +398,13 @@ Exports
 
 ### `src/client/composables/support/requestQueryRuntimeSupport.js`
 Exports
-- `appendRequestQueryValue(target = {}, key = "", values = [])`
-- `buildRequestQueryObject(entries = [])`
-- `createRequestQueryRuntime({ requestQueryParams = null, context = null, sourceQueryKey = null } = {})`
-- `resolveRequestQueryBaseKey(sourceQueryKey = null)`
+- `buildRequestQueryObject(entries = [], { fieldsets = null } = {})`
+- `createRequestQueryRuntime({ requestQueryParams = null, requestFieldsets = null, context = null, sourceQueryKey = null } = {})`
+Local functions
 - `resolveRequestQueryContext(context = null)`
+- `resolveRequestQueryBaseKey(sourceQueryKey = null)`
+- `resolveRequestFieldsets(requestFieldsets = null, context = {})`
+- `appendRequestQueryValue(target = {}, key = "", values = [])`
 
 ### `src/client/composables/support/resourceLoadStateHelpers.js`
 Exports
@@ -501,6 +503,8 @@ Local functions
 - `resetFilterValue(values, filter = {})`
 - `applyPresetFilterValue(values, filter = {}, rawValue)`
 - `createQueryParams(values, filterEntries = [])`
+- `resolveFilterRouteValue(filter, routeValue, { initial = false } = {})`
+- `createRouteQueryValueResolvers(filterEntries = [])`
 - `resolveAtomicValueLabel(filter = {}, value = "", labelResolvers = {})`
 - `formatDefaultChipLabel(filter = {}, chipValue, labelResolvers = {})`
 
@@ -521,7 +525,7 @@ Local functions
 
 ### `src/client/composables/useCrudListScreen.js`
 Exports
-- `useCrudListScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, readEnabled = true, requestRecoveryLabel = "Records", fallbackLoadError = "Unable to load records." } = {})`
+- `useCrudListScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiSuffix = "", recordIdParam = "recordId", recordIdSelector = null, titleFallbackFieldKey = "", viewUrlTemplate = "", editUrlTemplate = "", newUrlTemplate = "", recordChangedEvents = [], listFilters = {}, listBulkActions = [], listRowActions = [], syntheticRows = null, routeQueryBlacklist = Object.freeze(["include", "cursor", "limit"]), requestQueryParams = null, requestFieldsets = null, readEnabled = true, requestRecoveryLabel = "Records", fallbackLoadError = "Unable to load records." } = {})`
 Local functions
 - `formatCrudListCardValue(value)`
 - `asList(value = [])`
@@ -533,7 +537,7 @@ Local functions
 
 ### `src/client/composables/useCrudViewScreen.js`
 Exports
-- `useCrudViewScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = "Record", fallbackLoadError = "Unable to load record.", notFoundMessage = "Record not found." } = {})`
+- `useCrudViewScreen({ adapter = null, resource = null, resourceNamespace = "resource", apiUrlTemplate = "", recordIdParam = "recordId", titleFallbackFieldKey = "", listUrlTemplate = "", editUrlTemplate = "", recordChangedEvent = "", requestQueryParams = null, requestFieldsets = null, readEnabled = true, queryKeyFactory = null, requestRecoveryLabel = "Record", fallbackLoadError = "Unable to load record.", notFoundMessage = "Record not found." } = {})`
 
 ### `src/client/composables/usePagedCollection.js`
 Exports