refactor: rename tickets to collections

Author: johnleider

packages/0/src/composables/useGroup/index.test.ts

@@ -15,7 +15,7 @@ describe('useGroup', () => {
       expect(context).toHaveProperty('selectedIds')
       expect(context).toHaveProperty('selectedItems')
       expect(context).toHaveProperty('selectedValues')
-      expect(context).toHaveProperty('tickets')
+      expect(context).toHaveProperty('collection')
     })
 
     it('should initialize with empty context', () => {
@@ -24,7 +24,7 @@ describe('useGroup', () => {
       expect(context.selectedIds.size).toBe(0)
       expect(context.selectedItems.value.size).toBe(0)
       expect(context.selectedValues.value.size).toBe(0)
-      expect(context.tickets.size).toBe(0)
+      expect(context.collection.size).toBe(0)
     })
   })
 
@@ -41,7 +41,7 @@ describe('useGroup', () => {
       expect(ticket.index).toBe(0)
       expect(typeof ticket.isActive).toBe('boolean') // Ref
       expect(typeof ticket.toggle).toBe('function')
-      expect(context.tickets.size).toBe(1)
+      expect(context.collection.size).toBe(1)
     })
 
     it('should register items with custom values', () => {
@@ -57,17 +57,17 @@ describe('useGroup', () => {
       expect(ticket.disabled).toBe(true)
       expect(ticket.value).toBe('custom-value')
       expect(ticket.valueIsIndex).toBe(false)
-      expect(context.tickets.size).toBe(1)
+      expect(context.collection.size).toBe(1)
     })
 
     it('should unregister items', () => {
       const context = useGroup('test')[2]
 
       context.register({ id: 'test-item' })
-      expect(context.tickets.size).toBe(1)
+      expect(context.collection.size).toBe(1)
 
       context.unregister('test-item')
-      expect(context.tickets.size).toBe(0)
+      expect(context.collection.size).toBe(0)
     })
 
     it('should remove from selectedIds when unregistering', () => {
@@ -181,7 +181,7 @@ describe('useGroup', () => {
       context.mandate()
 
       if (context.selectedIds.size === 0) {
-        expect(context.tickets.size).toBe(2)
+        expect(context.collection.size).toBe(2)
       } else {
         expect(context.selectedIds.has('item1')).toBe(true)
         expect(context.selectedIds.size).toBe(1)

packages/0/src/composables/useGroup/index.ts

@@ -45,13 +45,13 @@ export type GroupOptions = {
 }
 
 /**
- * Creates a group registrar for managing group tickets within a specific namespace.
+ * Creates a group registrar for managing group items within a specific namespace.
  * This function provides a way to register, unregister, and manage group selections,
  * allowing for dynamic group management in applications.
  *
  * @param namespace The namespace for the group context.
  * @param options  Optional configuration for the group behavior.
- * @template Z The type of the group tickets managed by the registrar.
+ * @template Z The type of the group items managed by the registrar.
  * @template E The type of the group context.
  * @returns A tuple containing the inject function, provide function, and the group context.
  *
@@ -72,7 +72,7 @@ export function useGroup<
 
   const selectedItems = computed(() => {
     return new Set(
-      Array.from(selectedIds).map(id => registrar.tickets.get(id)),
+      Array.from(selectedIds).map(id => registrar.collection.get(id)),
     )
   })
 
@@ -93,15 +93,15 @@ export function useGroup<
   }
 
   function mandate () {
-    if (!options?.mandatory || selectedIds.size > 0 || registrar.tickets.size === 0) return
+    if (!options?.mandatory || selectedIds.size > 0 || registrar.collection.size === 0) return
 
     if (options.mandatory === 'force') {
-      const first = registrar.tickets.values().next().value
+      const first = registrar.collection.values().next().value
       if (first) selectedIds.add(first.id)
       return
     }
 
-    for (const item of registrar.tickets.values()) {
+    for (const item of registrar.collection.values()) {
       if (item.disabled) continue
       selectedIds.add(item.id)
 
@@ -127,7 +127,7 @@ export function useGroup<
     for (const id of Array.isArray(ids) ? ids : [ids]) {
       if (!id) continue
 
-      const item = registrar.tickets.get(id)
+      const item = registrar.collection.get(id)
 
       if (!item || item.disabled) continue
 
@@ -154,7 +154,7 @@ export function useGroup<
   function register (registrant: Partial<E>, id: ID = genId()): Reactive<E> {
     const item: Partial<E> = {
       disabled: false,
-      value: registrant?.value ?? registrar.tickets.size,
+      value: registrant?.value ?? registrar.collection.size,
       valueIsIndex: registrant?.value == null,
       isActive: toRef(() => selectedIds.has(ticket.id)),
       toggle: () => toggle(ticket.id),

packages/0/src/composables/useLocale/index.test.ts

@@ -55,7 +55,7 @@ describe('useLocale', () => {
       const state = createLocale('test', { adapter, messages })[2]
 
       expect(state.selectedId.value).toBeUndefined()
-      expect(state.tickets.size).toBe(0)
+      expect(state.collection.size).toBe(0)
     })
   })
 

packages/0/src/composables/useLocale/index.ts

@@ -41,7 +41,7 @@ export interface LocalePlugin {
  * @param namespace The namespace for the locale context.
  * @param options Configuration including adapter and messages.
  * @template Z The type of the locale context.
- * @template E The type of the locale tickets managed by the registrar.
+ * @template E The type of the locale items managed by the registrar.
  * @returns An array containing the inject function, provide function, and the locale context.
  */
 export function createLocale<
@@ -106,9 +106,9 @@ export function useLocale (): LocaleContext {
  *
  * @param options Configuration for adapter, default locale, and messages.
  * @template Z The type of the locale context.
- * @template E The type of the locale tickets managed by the registrar.
+ * @template E The type of the locale items managed by the registrar.
  * @template R The type of the token context.
- * @template O The type of the token tickets managed by the registrar.
+ * @template O The type of the token items managed by the registrar.
  * @returns Vue install function for the plugin
  */
 export function createLocalePlugin<

packages/0/src/composables/useRegistrar/index.test.ts

@@ -11,23 +11,23 @@ describe('useRegistrar', () => {
     const ticket1 = context.register({ id: 'item1' })
     expect(ticket1.id).toBe('item1')
     expect(ticket1.index).toBe(0)
-    expect(context.tickets.size).toBe(1)
+    expect(context.collection.size).toBe(1)
 
     const ticket2 = context.register()
     expect(ticket2.index).toBe(1)
-    expect(context.tickets.size).toBe(2)
+    expect(context.collection.size).toBe(2)
 
     const ticket3 = context.register({ id: 'item3' })
     expect(ticket3.id).toBe('item3')
     expect(ticket3.index).toBe(2)
-    expect(context.tickets.size).toBe(3)
+    expect(context.collection.size).toBe(3)
 
     context.unregister('item1')
-    expect(context.tickets.size).toBe(2)
-    expect(context.tickets.has('item1')).toBe(false)
+    expect(context.collection.size).toBe(2)
+    expect(context.collection.has('item1')).toBe(false)
 
-    expect(context.tickets.has(ticket2.id)).toBe(true)
-    expect(context.tickets.has('item3')).toBe(true)
+    expect(context.collection.has(ticket2.id)).toBe(true)
+    expect(context.collection.has('item3')).toBe(true)
   })
 
   it('should auto-generate unique IDs', () => {
@@ -37,7 +37,7 @@ describe('useRegistrar', () => {
     const ticket2 = context.register()
 
     expect(ticket1.id).not.toBe(ticket2.id)
-    expect(context.tickets.size).toBe(2)
+    expect(context.collection.size).toBe(2)
   })
 
   it('should maintain correct indices after reindexing', () => {
@@ -56,9 +56,9 @@ describe('useRegistrar', () => {
     const ticket4 = context.register({ id: 'item4' })
     expect(ticket4.index).toBe(2)
 
-    expect(context.tickets.has('item1')).toBe(true)
-    expect(context.tickets.has('item2')).toBe(false)
-    expect(context.tickets.has('item3')).toBe(true)
-    expect(context.tickets.has('item4')).toBe(true)
+    expect(context.collection.has('item1')).toBe(true)
+    expect(context.collection.has('item2')).toBe(false)
+    expect(context.collection.has('item3')).toBe(true)
+    expect(context.collection.has('item4')).toBe(true)
   })
 })

packages/0/src/composables/useRegistrar/index.ts

@@ -16,14 +16,14 @@ export interface RegistrarTicket {
 }
 
 export interface RegistrarContext {
-  tickets: Reactive<Map<ID, Reactive<any>>>
-  /** lookup a ticket by index number */
+  collection: Reactive<Map<ID, Reactive<any>>>
+  /** lookup an item by index number */
   lookup: (index: number) => ID | undefined
-  /** Find a ticket by id */
+  /** Find an item by id */
   find: (id: ID) => Reactive<any> | undefined
-  /** Register a new ticket */
-  register: (ticket?: Partial<RegistrarTicket>, id?: ID) => Reactive<any>
-  /** Unregister a ticket by id */
+  /** Register a new item */
+  register: (item?: Partial<RegistrarTicket>, id?: ID) => Reactive<any>
+  /** Unregister an item by id */
   unregister: (id: ID) => void
   /** Reset the index directory and update all items */
   reindex: () => void
@@ -33,7 +33,7 @@ export interface RegistrarContext {
  * A composable for managing a collection of info.
  * @param namespace The key to scope the context
  * @template Z The registry context interface.
- * @template E The structure of the tickets.
+ * @template E The structure of the collection.
  * @returns A trinity of registry methods.
  */
 export function useRegistrar<
@@ -42,11 +42,11 @@ export function useRegistrar<
 > (namespace: string) {
   const [useRegistrarContext, _provideRegistrarContext] = createContext<Z>(namespace)
 
-  const tickets = reactive(new Map<ID, E>())
+  const collection = reactive(new Map<ID, E>())
   const directory = reactive(new Map<number, ID>())
 
   function find (id: ID) {
-    return tickets.get(id) as E | undefined
+    return collection.get(id) as E | undefined
   }
 
   function lookup (index: number) {
@@ -56,7 +56,7 @@ export function useRegistrar<
   function reindex () {
     directory.clear()
     let index = 0
-    for (const item of tickets.values()) {
+    for (const item of collection.values()) {
       item.index = index
       directory.set(index, item.id)
       index++
@@ -66,29 +66,29 @@ export function useRegistrar<
   function register (registrant: Partial<E>, id: ID = genId()): Reactive<E> {
     const item = reactive({
       id,
-      index: registrant?.index ?? tickets.size,
+      index: registrant?.index ?? collection.size,
       ...registrant,
     }) as Reactive<E>
 
-    tickets.set(item.id, item as any)
+    collection.set(item.id, item as any)
     directory.set(item.index, item.id)
 
     return item
   }
 
   function unregister (id: ID) {
-    const item = tickets.get(id)
+    const item = collection.get(id)
 
     if (!item) return
 
     directory.delete(item.index)
-    tickets.delete(item.id)
+    collection.delete(item.id)
 
     reindex()
   }
 
   const context = {
-    tickets,
+    collection,
     lookup,
     find,
     register,

packages/0/src/composables/useSingle/index.test.ts

@@ -9,7 +9,7 @@ describe('useSingle', () => {
       expect(state.selectedIds.size).toBe(0)
       expect(state.selectedItems.value.size).toBe(0)
       expect(state.selectedValues.value.size).toBe(0)
-      expect(state.tickets.size).toBe(0)
+      expect(state.collection.size).toBe(0)
     })
   })
 

packages/0/src/composables/useSingle/index.ts

@@ -33,7 +33,7 @@ export type SingleContext = GroupContext & {
  *
  * @param namespace The namespace for the single context.
  * @param options Optional configuration for the single behavior.
- * @template Z The type of the single tickets managed by the registrar.
+ * @template Z The type of the single items managed by the registrar.
  * @template E The type of the single context.
  * @returns A tuple containing the inject function, provide function, and the single context.
  */
@@ -50,7 +50,7 @@ export function useSingle<
   const [useGroupContext, provideGroupContext, registrar] = useGroup<Z, E>(namespace, options)
 
   const selectedId = computed(() => registrar.selectedIds.values().next().value)
-  const selectedItem = computed(() => selectedId.value ? registrar.tickets.get(selectedId.value) : undefined)
+  const selectedItem = computed(() => selectedId.value ? registrar.collection.get(selectedId.value) : undefined)
   const selectedIndex = computed(() => selectedItem.value ? selectedItem.value.index : -1)
   const selectedValue = computed(() => selectedItem.value ? selectedItem.value.value : undefined)
 

packages/0/src/composables/useStep/index.test.ts

@@ -9,7 +9,7 @@ describe('useStep', () => {
       expect(state.selectedIds.size).toBe(0)
       expect(state.selectedItems.value.size).toBe(0)
       expect(state.selectedValues.value.size).toBe(0)
-      expect(state.tickets.size).toBe(0)
+      expect(state.collection.size).toBe(0)
       expect(state.selectedItem.value).toBeUndefined()
     })
   })
@@ -28,18 +28,18 @@ describe('useStep', () => {
       expect(ticket.index).toBe(0)
       expect(typeof ticket.isActive).toBe('boolean')
       expect(typeof ticket.toggle).toBe('function')
-      expect(state.tickets.size).toBe(1)
+      expect(state.collection.size).toBe(1)
     })
 
     it('should unregister items', () => {
       const [, provideStepContext, state] = useStep('test')
       const context = provideStepContext()
 
       context.register({ id: 'test-item' })
-      expect(state.tickets.size).toBe(1)
+      expect(state.collection.size).toBe(1)
 
       context.unregister('test-item')
-      expect(state.tickets.size).toBe(0)
+      expect(state.collection.size).toBe(0)
     })
   })
 

packages/0/src/composables/useStep/index.ts

@@ -24,7 +24,7 @@ export type StepContext = SingleContext & {
  *
  * @param namespace The namespace for the step context.
  * @param options Optional configuration for the step behavior.
- * @template Z The type of the step tickets managed by the registrar.
+ * @template Z The type of the step items managed by the registrar.
  * @template E The type of the step context.
  * @returns A tuple containing the inject function, provide function, and the step context.
  */
@@ -38,7 +38,7 @@ export function useStep<
   const [useGroupContext, provideGroupContext, registrar] = useSingle<Z, E>(namespace, options)
 
   function first () {
-    if (registrar.tickets.size === 0) return
+    if (registrar.collection.size === 0) return
 
     const firstId = registrar.lookup(0)
     if (firstId === undefined) return
@@ -48,9 +48,9 @@ export function useStep<
   }
 
   function last () {
-    if (registrar.tickets.size === 0) return
+    if (registrar.collection.size === 0) return
 
-    const lastIndex = registrar.tickets.size - 1
+    const lastIndex = registrar.collection.size - 1
     const lastId = registrar.lookup(lastIndex)
     if (lastId === undefined) return
 
@@ -71,15 +71,15 @@ export function useStep<
   }
 
   function step (count = 1) {
-    const length = registrar.tickets.size
+    const length = registrar.collection.size
     if (!length) return
 
     const direction = Math.sign(count || 1)
     let hops = 0
     let index = wrapped(length, registrar.selectedIndex.value + count)
     let id = registrar.lookup(index)
 
-    while (id !== undefined && registrar.tickets.get(id)?.disabled && hops < length) {
+    while (id !== undefined && registrar.collection.get(id)?.disabled && hops < length) {
       index = wrapped(length, index + direction)
       id = registrar.lookup(index)
       hops++