[CMS] - Implemented sort

[bnGil]

Add Sorting Support to CMS Collection

Implements sorting functionality for CMS collections following the CMS Collection Interface specification.

Changes

Service Layer (cms-collection-service.ts)

• Added sortSignal to track current sort state
• Added setSort() method to update sort and reload items
• Added initialSort to service configuration
• Updated loadCollectionItems() to apply sort using query.ascending() / query.descending()
• Updated loadCmsCollectionServiceInitialData() to accept optional sort parameter

Components

• New: CmsCollectionSort.tsx - Headless component providing sort state from service
• New: CmsCollection.Sort - Styled wrapper around Sort primitive with CMS state management
• New: CmsCollection.SortOption - Re-export of Sort primitive's Option component
• Updated CmsCollection.Root to accept initialSort in collection config

Features

• ✅ Supports dynamic field names (unknown schemas)
• ✅ Native <select> and custom list rendering modes
• ✅ AsChild pattern support for full customization
• ✅ Automatic collection reload on sort change
• ✅ Preserves sort state during pagination
• ✅ Data attributes for testing: data-sorted-by, data-sort-direction

Usage Examples

// Native select
<CmsCollection.Sort
  as="select"
  sortOptions={[
    { fieldName: 'title', order: 'ASC', label: 'Title (A-Z)' },
    { fieldName: 'created', order: 'DESC', label: 'Newest First' },
  ]}
/>

// Custom buttons
<CmsCollection.Sort as="list">
  <CmsCollection.SortOption fieldName="title" order="ASC" label="Title (A-Z)" />
  <CmsCollection.SortOption fieldName="created" order="DESC" label="Newest" />
</CmsCollection.Sort>

Technical Notes

• Uses platform Sort primitive for consistent behavior across packages
• Sort state is reactive (signal-based) and triggers automatic reloads
• Designed for extensibility (supports SortValue array for future multi-sort)
• Currently applies first sort item only (Wix Data SDK limitation)

[jordanlaor]

1. update the package version :)
2. can you have multiple sorts? How do you do that?

[bnGil]

1. update the package version :)
2. can you have multiple sorts? How do you do that?

What do you mean by multiple sorts?