refactor(useRegistry): rename to useRegistry

Author: johnleider

.github/.instructions-0.md

@@ -57,7 +57,7 @@ Components in this library should be:
 | `useHydration` | Manage SSR hydration process and optimization | `src/composables/useHydration/` |
 | `useKeydown` | Handle keyboard events with automatic cleanup | `src/composables/useKeydown/` |
 | `useLocale` | Internationalization with multiple languages and interpolation | `src/composables/useLocale/` |
-| `useRegistrar` | Foundation for registration-based systems | `src/composables/useRegistrar/` |
+| `useRegistry` | Foundation for registration-based systems | `src/composables/useRegistry/` |
 | `useStep` | Manage multi-step process state | `src/composables/useStep/` |
 | `useTheme` | Theme management with dynamic switching | `src/composables/useTheme/` |
 | `useTokens` | Design token system management | `src/composables/useTokens/` |

README.md

@@ -28,7 +28,7 @@ Core foundational components and composables:
 - `useHydration` - SSR hydration helpers
 - `useKeydown` - Keyboard event handling
 - `useLocale` - Internationalization support
-- `useRegistrar` - Component registration system
+- `useRegistry` - Component registration system
 - `useStep` - Step navigation logic
 - `useTheme` - Theme switching and CSS variable management
 - `useTokens` - Design token system

apps/docs/src/components/app/AppNav.vue

@@ -45,7 +45,7 @@
         {
           name: 'Registration',
           children: [
-            { name: 'useRegistrar', to: '/composables/registration/use-registrar' },
+            { name: 'useRegistry', to: '/composables/registration/use-registry' },
             { name: 'useTokens', to: '/composables/registration/use-tokens' },
           ],
         },

apps/docs/src/pages/composables/index.md

@@ -14,7 +14,7 @@ Reusable pieces of logic that can be shared across components, providing encapsu
 | [useKeydown](/composables/use-keydown) | Handle keyboard events with automatic cleanup |
 | [useLocale](/composables/use-locale) | Internationalization system for multiple languages |
 | [useMarkdown](/composables/use-markdown) | Render Markdown content in Vue applications |
-| [useRegistrar](/composables/use-registrar) | Foundation for registration-based systems |
+| [useRegistry](/composables/use-registry) | Foundation for registration-based systems |
 | [useSingle](/composables/use-single) | Simplified single-selection wrapper around useGroup |
 | [useStep](/composables/use-step) | Manage multi-step processes like forms or wizards |
 | [useStorage](/composables/use-storage) | Reactive interface to browser storage APIs |

apps/docs/src/pages/composables/registration/use-registrar.md

@@ -1,3 +1,3 @@
-# useRegistrar
+# useRegistry
 
 A foundational composable for building registration-based systems, managing collections of registered items with automatic indexing and lifecycle management.

packages/0/src/components/Avatar/AvatarRoot.vue

@@ -3,36 +3,36 @@
   import { Atom } from '#v0/components/Atom'
 
   // Composables
-  import { useRegistrar } from '#v0/composables'
+  import { useRegistry } from '#v0/composables'
 
   // Utilities
   import { computed, toRef } from 'vue'
 
   // Types
   import type { AtomProps } from '#v0/components/Atom'
-  import type { RegistrarContext, RegistrarItem, RegistrarTicket } from '#v0/composables'
+  import type { RegistryContext, RegistryItem, RegistryTicket } from '#v0/composables'
   import type { ComputedGetter } from 'vue'
 
   export interface AvatarRootProps extends AtomProps {}
 
-  export interface AvatarItem extends RegistrarItem {
+  export interface AvatarItem extends RegistryItem {
     type: 'image' | 'fallback'
     priority: number
     status: 'idle' | 'loading' | 'loaded' | 'error'
   }
 
-  interface AvatarTicket extends RegistrarTicket {
+  interface AvatarTicket extends RegistryTicket {
     type: AvatarItem['type']
     priority: AvatarItem['priority']
     status: AvatarItem['status']
     isVisible: Readonly<ComputedGetter<boolean>>
   }
 
-  export interface AvatarContext extends RegistrarContext<AvatarTicket, AvatarItem> {
+  export interface AvatarContext extends RegistryContext<AvatarTicket, AvatarItem> {
     reset: () => void
   }
 
-  export const [useAvatarContext, provideAvatarContext, registrar] = useRegistrar<AvatarTicket, AvatarContext>('avatar')
+  export const [useAvatarContext, provideAvatarContext, registry] = useRegistry<AvatarTicket, AvatarContext>('avatar')
 </script>
 
 <script setup lang="ts">
@@ -41,13 +41,13 @@
   const { as = 'div', renderless } = defineProps<AvatarRootProps>()
 
   const imageItems = computed(() => (
-    Array.from(registrar.registeredItems.values())
+    Array.from(registry.registeredItems.values())
       .filter(item => item.type === 'image')
       .toSorted((a, b) => a.priority - b.priority)
   ))
 
   const fallbackItems = computed(() => (
-    Array.from(registrar.registeredItems.values())
+    Array.from(registry.registeredItems.values())
       .filter(item => item.type === 'fallback')
   ))
 
@@ -64,14 +64,14 @@
     return undefined
   })
 
-  const register: typeof registrar.register = createAvatarItem => {
-    const ticket = registrar.register(order => {
-      const avatarItem = registrar.intake(order, createAvatarItem)
+  const register: typeof registry.register = createAvatarItem => {
+    const ticket = registry.register(order => {
+      const avatarItem = registry.intake(order, createAvatarItem)
 
       return {
         ...avatarItem,
         type: avatarItem?.type ?? 'fallback',
-        priority: avatarItem?.priority ?? registrar.registeredItems.size,
+        priority: avatarItem?.priority ?? registry.registeredItems.size,
         status: avatarItem?.status ?? 'idle',
         isVisible: toRef(() => visibleItem.value?.id === order.id),
       }
@@ -81,15 +81,15 @@
   }
 
   function reset () {
-    for (const item of registrar.registeredItems.values()) {
+    for (const item of registry.registeredItems.values()) {
       if (item.type === 'image') {
         item.status = 'idle'
       }
     }
   }
 
   provideAvatarContext({
-    ...registrar,
+    ...registry,
     register,
     reset,
   })

packages/0/src/composables/index.ts

@@ -5,7 +5,7 @@ export * from './useHydration'
 export * from './useKeydown'
 export * from './useLocale'
 export * from './useLogger'
-export * from './useRegistrar'
+export * from './useRegistry'
 export * from './useSingle'
 export * from './useStep'
 export * from './useStorage'

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

@@ -2,18 +2,18 @@
 import { createTrinity } from '#v0/factories/createTrinity'
 
 // Composables
-import { useRegistrar } from '#v0/composables/useRegistrar'
+import { useRegistry } from '#v0/composables/useRegistry'
 
 // Utilities
 import { computed, getCurrentInstance, nextTick, onMounted, reactive, toRef, toValue, watch } from 'vue'
 import { genId } from '#v0/utilities/helpers'
 
 // Types
 import type { App, ComputedGetter, ComputedRef, Reactive, Ref } from 'vue'
-import type { RegistrarContext, RegistrarTicket } from '#v0/composables/useRegistrar'
+import type { RegistryContext, RegistryTicket } from '#v0/composables/useRegistry'
 import type { ID } from '#v0/types'
 
-export type GroupTicket = RegistrarTicket & {
+export type GroupTicket = RegistryTicket & {
   disabled: boolean
   value: unknown
   valueIsIndex: boolean
@@ -22,7 +22,7 @@ export type GroupTicket = RegistrarTicket & {
   toggle: () => void
 }
 
-export type GroupContext = RegistrarContext & {
+export type GroupContext = RegistryContext & {
   selectedItems: ComputedRef<Set<GroupTicket | undefined>>
   selectedIndexes: ComputedRef<Set<number>>
   selectedIds: Reactive<Set<ID>>
@@ -46,13 +46,13 @@ export type GroupOptions = {
 }
 
 /**
- * Creates a group registrar for managing group items within a specific namespace.
+ * Creates a group registry 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 items managed by the registrar.
+ * @template Z The type of the group items managed by the registry.
  * @template E The type of the group context.
  * @returns A tuple containing the inject function, provide function, and the group context.
  *
@@ -65,15 +65,15 @@ export function useGroup<
   namespace: string,
   options?: GroupOptions,
 ) {
-  const [useRegistrarContext, provideRegistrarContext, registrar] = useRegistrar<Z, E>(namespace)
+  const [useRegistryContext, provideRegistryContext, registry] = useRegistry<Z, E>(namespace)
 
   const catalog = reactive(new Map<unknown, ID>())
   const selectedIds = reactive(new Set<ID>())
   let initialValue: unknown | unknown[] = null
 
   const selectedItems = computed(() => {
     return new Set(
-      Array.from(selectedIds).map(id => registrar.collection.get(id)),
+      Array.from(selectedIds).map(id => registry.collection.get(id)),
     )
   })
 
@@ -94,17 +94,17 @@ export function useGroup<
   }
 
   function mandate () {
-    if (!options?.mandatory || selectedIds.size > 0 || registrar.collection.size === 0) return
+    if (!options?.mandatory || selectedIds.size > 0 || registry.collection.size === 0) return
 
     if (options.mandatory === 'force') {
-      const first = registrar.collection.values().next().value
+      const first = registry.collection.values().next().value
 
       if (first) selectedIds.add(first.id)
 
       return
     }
 
-    for (const item of registrar.collection.values()) {
+    for (const item of registry.collection.values()) {
       if (item.disabled) continue
       selectedIds.add(item.id)
 
@@ -113,7 +113,7 @@ export function useGroup<
   }
 
   function reindex () {
-    registrar.reindex()
+    registry.reindex()
   }
 
   function reset () {
@@ -130,7 +130,7 @@ export function useGroup<
     for (const id of Array.isArray(ids) ? ids : [ids]) {
       if (!id) continue
 
-      const item = registrar.collection.get(id)
+      const item = registry.collection.get(id)
 
       if (!item || item.disabled) continue
 
@@ -157,14 +157,14 @@ export function useGroup<
   function register (registrant: Partial<E>, id: ID = genId()): Reactive<E> {
     const item: Partial<E> = {
       disabled: false,
-      value: registrant?.value ?? registrar.collection.size,
+      value: registrant?.value ?? registry.collection.size,
       valueIsIndex: registrant?.value == null,
       isActive: toRef(() => selectedIds.has(ticket.id)),
       toggle: () => toggle(ticket.id),
       ...registrant,
     }
 
-    const ticket = registrar.register(item, id)
+    const ticket = registry.register(item, id)
 
     catalog.set(ticket.value, ticket.id)
 
@@ -183,7 +183,7 @@ export function useGroup<
 
   function unregister (id: ID) {
     selectedIds.delete(id)
-    registrar.unregister(id)
+    registry.unregister(id)
   }
 
   if (getCurrentInstance()) {
@@ -193,7 +193,7 @@ export function useGroup<
   }
 
   const context = {
-    ...registrar,
+    ...registry,
     selectedItems,
     selectedIndexes,
     selectedIds,
@@ -255,8 +255,8 @@ export function useGroup<
       })
     }
 
-    return provideRegistrarContext(model, _context, app)
+    return provideRegistryContext(model, _context, app)
   }
 
-  return createTrinity<Z>(useRegistrarContext, provideGroupContext, context)
+  return createTrinity<Z>(useRegistryContext, provideGroupContext, context)
 }

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

@@ -36,12 +36,12 @@ export interface LocalePlugin {
 }
 
 /**
- * Creates a locale registrar for managing locale translations and number formatting.
+ * Creates a locale registry for managing locale translations and number formatting.
  *
  * @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 items managed by the registrar.
+ * @template E The type of the locale items managed by the registry.
  * @returns An array containing the inject function, provide function, and the locale context.
  */
 export function createLocale<
@@ -52,7 +52,7 @@ export function createLocale<
   options: LocalePluginOptions = {},
 ) {
   const { adapter = new Vuetify0LocaleAdapter(), messages = {} } = options
-  const [useLocaleContext, provideLocaleContext, registrar] = useSingle<Z, E>(namespace)
+  const [useLocaleContext, provideLocaleContext, registry] = useSingle<Z, E>(namespace)
 
   function resolve (locale: ID, str: string): string {
     return str.replace(/{([a-zA-Z0-9.-_]+)}/g, (match, linkedKey) => {
@@ -67,7 +67,7 @@ export function createLocale<
   }
 
   function t (key: string, ...params: unknown[]): string {
-    const locale = registrar.selectedId.value
+    const locale = registry.selectedId.value
 
     if (!locale) return key
 
@@ -81,11 +81,11 @@ export function createLocale<
   }
 
   function n (value: number, ...params: unknown[]): string {
-    return adapter.n(value, registrar.selectedId.value, ...params)
+    return adapter.n(value, registry.selectedId.value, ...params)
   }
 
   return createTrinity<Z>(useLocaleContext, provideLocaleContext, {
-    ...registrar,
+    ...registry,
     t,
     n,
   } as Z)
@@ -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 items managed by the registrar.
+ * @template E The type of the locale items managed by the registry.
  * @template R The type of the token context.
- * @template O The type of the token items managed by the registrar.
+ * @template O The type of the token items managed by the registry.
  * @returns Vue install function for the plugin
  */
 export function createLocalePlugin<