@refraction-ui/astro 0.4.2 → 0.4.4

package/dist/astro-search-bar/SearchBar.astro

@@ -2,7 +2,7 @@
 import {
   createSearchBar,
   searchBarVariants,
-} from '@refraction-ui/search-bar'
+} from '../search-bar/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-search-bar/SearchResults.astro

@@ -1,5 +1,5 @@
 ---
-import { searchResultVariants } from '@refraction-ui/search-bar'
+import { searchResultVariants } from '../search-bar/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {}

package/dist/astro-select/Select.astro

@@ -1,5 +1,5 @@
 ---
-import { createSelect } from '@refraction-ui/select'
+import { createSelect } from '../select/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {
   value?: string

package/dist/astro-select/SelectContent.astro

@@ -1,5 +1,5 @@
 ---
-import { selectContentVariants } from '@refraction-ui/select'
+import { selectContentVariants } from '../select/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {}

package/dist/astro-select/SelectItem.astro

@@ -1,5 +1,5 @@
 ---
-import { selectItemVariants } from '@refraction-ui/select'
+import { selectItemVariants } from '../select/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-select/SelectTrigger.astro

@@ -1,5 +1,5 @@
 ---
-import { selectTriggerVariants } from '@refraction-ui/select'
+import { selectTriggerVariants } from '../select/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-sidebar/Sidebar.astro

@@ -4,7 +4,7 @@ import {
   sidebarVariants,
   sidebarItemVariants,
   type SidebarSection,
-} from '@refraction-ui/sidebar'
+} from '../sidebar/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-skeleton/Skeleton.astro

@@ -3,7 +3,7 @@ import {
   createSkeleton,
   skeletonVariants,
   type SkeletonShape,
-} from '@refraction-ui/skeleton'
+} from '../skeleton/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-slide-viewer/SlideViewer.astro

@@ -5,7 +5,7 @@ import {
   progressBarVariants,
   slideTypeBadgeVariants,
   type SlideData,
-} from '@refraction-ui/slide-viewer'
+} from '../slide-viewer/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-status-indicator/StatusIndicator.astro

@@ -6,7 +6,7 @@ import {
   statusPulseVariants,
   statusLabelStyles,
   type StatusType,
-} from '@refraction-ui/status-indicator'
+} from '../status-indicator/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props {

package/dist/astro-switch/Switch.astro

@@ -3,7 +3,7 @@ import {
   createSwitch,
   switchVariants,
   switchThumbVariants,
-} from '@refraction-ui/switch'
+} from '../switch/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-table-of-contents/TableOfContents.astro

@@ -14,7 +14,7 @@ const { selectors = 'h2, h3, h4', class: className, ...props } = Astro.props;
 </nav>
 
 <script>
-  import { parseHeadings, observeHeadings } from '@refraction-ui/table-of-contents';
+  import { parseHeadings, observeHeadings } from '../table-of-contents/index.ts';
 
   document.querySelectorAll('.refraction-toc').forEach((el) => {
     const selectors = el.getAttribute('data-selectors') || 'h2, h3, h4';

package/dist/astro-tabs/Tabs.astro

@@ -1,5 +1,5 @@
 ---
-import { createTabs } from '@refraction-ui/tabs'
+import { createTabs } from '../tabs/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {
   defaultValue?: string

package/dist/astro-tabs/TabsList.astro

@@ -1,5 +1,5 @@
 ---
-import { tabsListVariants } from '@refraction-ui/tabs'
+import { tabsListVariants } from '../tabs/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {}

package/dist/astro-tabs/TabsTrigger.astro

@@ -1,5 +1,5 @@
 ---
-import { tabsTriggerVariants } from '@refraction-ui/tabs'
+import { tabsTriggerVariants } from '../tabs/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-textarea/Textarea.astro

@@ -2,7 +2,7 @@
 import {
   createTextarea,
   textareaVariants,
-} from '@refraction-ui/textarea'
+} from '../textarea/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-theme/ThemeScript.astro

@@ -1,5 +1,5 @@
 ---
-import { getThemeScript } from '@refraction-ui/theme'
+import { getThemeScript } from '../theme/index.ts'
 
 interface Props {
   storageKey?: string

package/dist/astro-thread-view/ThreadView.astro

@@ -14,7 +14,7 @@ import {
   threadAttachmentStyles,
   threadEditedStyles,
   type MessageData,
-} from '@refraction-ui/thread-view'
+} from '../thread-view/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-toast/Toast.astro

@@ -1,5 +1,5 @@
 ---
-import { toastVariants, type ToastVariant } from '@refraction-ui/toast'
+import { toastVariants, type ToastVariant } from '../toast/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-tooltip/TooltipContent.astro

@@ -1,5 +1,5 @@
 ---
-import { tooltipContentVariants } from '@refraction-ui/tooltip'
+import { tooltipContentVariants } from '../tooltip/index.ts'
 import { cn } from '../shared/index.ts'
 import type { Side } from '../shared/index.ts'
 

package/dist/astro-version-selector/VersionSelector.astro

@@ -5,7 +5,7 @@ import {
   optionVariants,
   latestBadgeVariants,
   type VersionOption,
-} from '@refraction-ui/version-selector'
+} from '../version-selector/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/astro-video-player/VideoPlayer.astro

@@ -4,7 +4,7 @@ import {
   playerVariants,
   controlsVariants,
   overlayVariants,
-} from '@refraction-ui/video-player'
+} from '../video-player/index.ts'
 import { cn } from '../shared/index.ts'
 
 interface Props extends astroHTML.JSX.HTMLAttributes {

package/dist/auth/adapters/mock.ts

@@ -0,0 +1,74 @@
+import type { AuthAdapter, User } from '../types.js'
+
+/**
+ * Mock auth adapter for testing and development.
+ * No external dependencies. Stores state in memory.
+ */
+export function createMockAdapter(initialUser?: User): AuthAdapter {
+  let currentUser: User | null = initialUser ?? null
+  const listeners = new Set<(user: User | null) => void>()
+
+  function notify() {
+    for (const fn of listeners) {
+      fn(currentUser)
+    }
+  }
+
+  return {
+    async signIn(email, _password) {
+      currentUser = {
+        uid: 'mock-' + email,
+        email,
+        displayName: email.split('@')[0],
+        photoURL: null,
+        roles: ['student'],
+      }
+      notify()
+      return currentUser
+    },
+
+    async signInWithOAuth(_provider) {
+      currentUser = {
+        uid: 'mock-oauth',
+        email: 'oauth@example.com',
+        displayName: 'OAuth User',
+        photoURL: null,
+        roles: ['student'],
+      }
+      notify()
+      return currentUser
+    },
+
+    async signUp(email, _password, displayName) {
+      currentUser = {
+        uid: 'mock-' + email,
+        email,
+        displayName,
+        photoURL: null,
+        roles: ['student'],
+      }
+      notify()
+      return currentUser
+    },
+
+    async signOut() {
+      currentUser = null
+      notify()
+    },
+
+    async resetPassword(_email) {
+      // no-op in mock
+    },
+
+    async getToken() {
+      return currentUser ? 'mock-token-' + currentUser.uid : null
+    },
+
+    onAuthStateChange(callback) {
+      listeners.add(callback)
+      // Fire immediately with current state
+      callback(currentUser)
+      return () => { listeners.delete(callback) }
+    },
+  }
+}

package/dist/auth/auth-machine.ts

@@ -0,0 +1,120 @@
+import type { User, AuthState, AuthStatus, AuthConfig, AuthAdapter, OAuthProvider } from './types.js'
+
+export interface AuthAPI {
+  getState(): AuthState
+  signIn(email: string, password: string): Promise<User>
+  signInWithOAuth(provider: OAuthProvider): Promise<User>
+  signUp(email: string, password: string, displayName: string): Promise<User>
+  signOut(): Promise<void>
+  resetPassword(email: string): Promise<void>
+  getToken(): Promise<string | null>
+  subscribe(fn: (state: AuthState) => void): () => void
+  destroy(): void
+}
+
+export function createAuth(
+  adapter: AuthAdapter,
+  config: Omit<AuthConfig, 'adapter'> = {},
+): AuthAPI {
+  const listeners = new Set<(state: AuthState) => void>()
+  let state: AuthState = { user: null, status: 'loading' }
+  let unsubAuth: (() => void) | null = null
+  let tokenRefreshTimer: ReturnType<typeof setInterval> | null = null
+
+  const { tokenRefreshInterval = 50, testMode = false, testUser } = config
+
+  function setState(newState: AuthState) {
+    state = newState
+    for (const fn of listeners) {
+      fn(state)
+    }
+  }
+
+  function setUser(user: User | null) {
+    setState({
+      user,
+      status: user ? 'authenticated' : 'unauthenticated',
+    })
+  }
+
+  // Start token refresh timer
+  function startTokenRefresh() {
+    if (tokenRefreshTimer) clearInterval(tokenRefreshTimer)
+    tokenRefreshTimer = setInterval(
+      () => { adapter.getToken().catch(() => {}) },
+      tokenRefreshInterval * 60 * 1000,
+    )
+  }
+
+  // Initialize
+  if (testMode && testUser) {
+    setUser(testUser)
+  } else {
+    unsubAuth = adapter.onAuthStateChange((user) => {
+      setUser(user)
+      if (user) {
+        startTokenRefresh()
+      } else if (tokenRefreshTimer) {
+        clearInterval(tokenRefreshTimer)
+        tokenRefreshTimer = null
+      }
+    })
+  }
+
+  return {
+    getState() {
+      return state
+    },
+
+    async signIn(email, password) {
+      const user = await adapter.signIn(email, password)
+      setUser(user)
+      startTokenRefresh()
+      return user
+    },
+
+    async signInWithOAuth(provider) {
+      const user = await adapter.signInWithOAuth(provider)
+      setUser(user)
+      startTokenRefresh()
+      return user
+    },
+
+    async signUp(email, password, displayName) {
+      const user = await adapter.signUp(email, password, displayName)
+      setUser(user)
+      startTokenRefresh()
+      return user
+    },
+
+    async signOut() {
+      await adapter.signOut()
+      if (tokenRefreshTimer) {
+        clearInterval(tokenRefreshTimer)
+        tokenRefreshTimer = null
+      }
+      setUser(null)
+    },
+
+    async resetPassword(email) {
+      await adapter.resetPassword(email)
+    },
+
+    async getToken() {
+      return adapter.getToken()
+    },
+
+    subscribe(fn) {
+      listeners.add(fn)
+      return () => { listeners.delete(fn) }
+    },
+
+    destroy() {
+      listeners.clear()
+      unsubAuth?.()
+      if (tokenRefreshTimer) {
+        clearInterval(tokenRefreshTimer)
+      }
+    },
+  }
+}

package/dist/auth/index.ts

@@ -0,0 +1,22 @@
+export type {
+  User,
+  AuthState,
+  AuthStatus,
+  OAuthProvider,
+  AuthConfig,
+  AuthAdapter,
+} from './types.js'
+
+export { createAuth, type AuthAPI } from './auth-machine.js'
+
+export {
+  hasRole,
+  hasAnyRole,
+  hasAllRoles,
+  canAccessAdmin,
+  canAccessReviewer,
+  getDefaultPortal,
+  getAssignableRoles,
+} from './rbac.js'
+
+export { createMockAdapter } from './adapters/mock.js'

package/dist/auth/rbac.ts

@@ -0,0 +1,44 @@
+import type { User } from './types.js'
+
+/** Check if user has a specific role */
+export function hasRole(user: User | null, role: string): boolean {
+  return user?.roles?.includes(role) ?? false
+}
+
+/** Check if user has any of the specified roles */
+export function hasAnyRole(user: User | null, roles: string[]): boolean {
+  if (!user?.roles) return false
+  return roles.some((role) => user.roles.includes(role))
+}
+
+/** Check if user has all of the specified roles */
+export function hasAllRoles(user: User | null, roles: string[]): boolean {
+  if (!user?.roles) return false
+  return roles.every((role) => user.roles.includes(role))
+}
+
+/** Convenience role checks */
+export function canAccessAdmin(user: User | null): boolean {
+  return hasRole(user, 'admin')
+}
+
+export function canAccessReviewer(user: User | null): boolean {
+  return hasAnyRole(user, ['admin', 'reviewer'])
+}
+
+/** Get the default portal URL based on highest-privilege role */
+export function getDefaultPortal(roles: string[]): string {
+  if (roles.includes('admin')) return '/admin'
+  if (roles.includes('reviewer')) return '/reviewer'
+  if (roles.includes('parent')) return '/parent'
+  if (roles.includes('student')) return '/student'
+  return '/'
+}
+
+/** Get roles that the given user can assign to others */
+export function getAssignableRoles(user: User | null): string[] {
+  if (!user) return []
+  if (hasRole(user, 'admin')) return ['admin', 'reviewer', 'parent', 'student']
+  if (hasRole(user, 'reviewer')) return ['student']
+  return []
+}

package/dist/auth/types.ts

@@ -0,0 +1,44 @@
+/** User object — framework-agnostic, provider-agnostic */
+export interface User {
+  uid: string
+  email: string | null
+  displayName: string | null
+  photoURL: string | null
+  roles: string[]
+}
+
+/** Auth state */
+export type AuthStatus = 'loading' | 'authenticated' | 'unauthenticated'
+
+export interface AuthState {
+  user: User | null
+  status: AuthStatus
+}
+
+/** OAuth providers */
+export type OAuthProvider = string
+
+/**
+ * AuthAdapter — interface implemented by provider adapters (e.g. Firebase, Supabase, Auth0).
+ * Consumers must provide an implementation of this adapter to the AuthProvider.
+ */
+export interface AuthAdapter {
+  signIn(email: string, password: string): Promise<User>
+  signInWithOAuth(provider: OAuthProvider): Promise<User>
+  signUp(email: string, password: string, displayName: string): Promise<User>
+  signOut(): Promise<void>
+  resetPassword(email: string): Promise<void>
+  getToken(): Promise<string | null>
+  onAuthStateChange(callback: (user: User | null) => void): () => void
+}
+
+export interface AuthConfig {
+  /** The adapter implementation for your specific auth provider (Supabase, Firebase, Auth0, Custom, etc.) */
+  adapter: AuthAdapter
+  /** Token refresh interval in minutes. Default: 50 */
+  tokenRefreshInterval?: number
+  /** Enable E2E test mode with mock user */
+  testMode?: boolean
+  /** Mock user for test mode */
+  testUser?: User
+}

package/dist/avatar/avatar.styles.ts

@@ -0,0 +1,47 @@
+import { cva } from '../shared/index.ts'
+import type { TokenContract } from '../shared/index.ts'
+
+export const avatarTokens: TokenContract = {
+  name: 'avatar',
+  tokens: {
+    bg: { variable: '--rfr-avatar-bg', fallback: 'hsl(var(--muted))' },
+    fg: { variable: '--rfr-avatar-fg', fallback: 'hsl(var(--muted-foreground))' },
+    border: { variable: '--rfr-avatar-border', fallback: 'hsl(var(--border))' },
+  },
+}
+
+export const avatarVariants = cva({
+  base: 'relative flex shrink-0 overflow-hidden rounded-full',
+  variants: {
+    size: {
+      xs: 'h-6 w-6',
+      sm: 'h-8 w-8',
+      md: 'h-10 w-10',
+      lg: 'h-12 w-12',
+      xl: 'h-16 w-16',
+    },
+  },
+  defaultVariants: {
+    size: 'md',
+  },
+})
+
+export const avatarImageVariants = cva({
+  base: 'aspect-square h-full w-full object-cover',
+})
+
+export const avatarFallbackVariants = cva({
+  base: 'flex h-full w-full items-center justify-center rounded-full bg-muted text-muted-foreground',
+  variants: {
+    size: {
+      xs: 'text-xs',
+      sm: 'text-xs',
+      md: 'text-sm',
+      lg: 'text-base',
+      xl: 'text-lg',
+    },
+  },
+  defaultVariants: {
+    size: 'md',
+  },
+})

package/dist/avatar/avatar.ts

@@ -0,0 +1,73 @@
+import type { AccessibilityProps } from '../shared/index.ts'
+
+export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl'
+
+export type AvatarLoadingStatus = 'idle' | 'loading' | 'loaded' | 'error'
+
+export interface AvatarProps {
+  src?: string
+  alt?: string
+  fallback?: string
+  size?: AvatarSize
+}
+
+export interface AvatarAPI {
+  /** ARIA attributes to spread on the root element */
+  ariaProps: Partial<AccessibilityProps>
+  /** Data attributes for CSS styling hooks */
+  dataAttributes: Record<string, string>
+  /** Image ARIA props */
+  imageProps: {
+    alt: string
+    role: string
+  }
+  /** Fallback text (initials) */
+  fallbackText: string
+  /** Current state */
+  state: {
+    size: AvatarSize
+    hasSrc: boolean
+  }
+}
+
+/**
+ * Extract initials from a name or fallback string.
+ * Takes first letter of first two words, uppercased.
+ */
+export function getInitials(name: string): string {
+  const parts = name.trim().split(/\s+/)
+  if (parts.length === 0 || parts[0] === '') return ''
+  if (parts.length === 1) return parts[0].charAt(0).toUpperCase()
+  return (parts[0].charAt(0) + parts[parts.length - 1].charAt(0)).toUpperCase()
+}
+
+export function createAvatar(props: AvatarProps = {}): AvatarAPI {
+  const { src, alt = '', fallback = '', size = 'md' } = props
+
+  const ariaProps: Partial<AccessibilityProps> = {
+    role: 'img',
+  }
+  if (alt) {
+    ariaProps['aria-label'] = alt
+  }
+
+  const fallbackText = fallback ? getInitials(fallback) : (alt ? getInitials(alt) : '')
+
+  const dataAttributes: Record<string, string> = {
+    'data-slot': 'avatar',
+  }
+
+  return {
+    ariaProps,
+    dataAttributes,
+    imageProps: {
+      alt,
+      role: 'img',
+    },
+    fallbackText,
+    state: {
+      size,
+      hasSrc: !!src,
+    },
+  }
+}

package/dist/avatar/index.ts

@@ -0,0 +1,15 @@
+export {
+  createAvatar,
+  getInitials,
+  type AvatarProps,
+  type AvatarAPI,
+  type AvatarSize,
+  type AvatarLoadingStatus,
+} from './avatar.js'
+
+export {
+  avatarVariants,
+  avatarImageVariants,
+  avatarFallbackVariants,
+  avatarTokens,
+} from './avatar.styles.js'