@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/chunk-HO2GKTWJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/hooks/use-boolean.ts"],"names":[],"mappings":";;AAiEO,SAAS,UAAA,CAAW,eAAe,KAAA,EAAyB;AACjE,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAS,YAAY,CAAA;AAE/C,EAAA,MAAM,MAAA,GAAS,YAAY,MAAM;AAC/B,IAAA,QAAA,CAAS,IAAI,CAAA;AAAA,EACf,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,OAAA,GAAU,YAAY,MAAM;AAChC,IAAA,QAAA,CAAS,KAAK,CAAA;AAAA,EAChB,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,MAAM,QAAA,GAAW,YAAY,MAAM;AACjC,IAAA,QAAA,CAAS,CAAC,IAAA,KAAS,CAAC,IAAI,CAAA;AAAA,EAC1B,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO,OAAA;AAAA,IACL,OAAO;AAAA,MACL,KAAA;AAAA,MACA,MAAA;AAAA,MACA,OAAA;AAAA,MACA,QAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAA,EAAS,QAAQ;AAAA,GACnC;AACF","file":"chunk-HO2GKTWJ.js","sourcesContent":["'use client';\n\n/**\n * useBoolean Hook\n *\n * A hook for managing boolean state with convenient toggle methods.\n *\n * @module @omnitron-dev/prism/core/hooks/use-boolean\n */\n\nimport { useState, useCallback, useMemo } from 'react';\n\n/**\n * Return type for useBoolean hook.\n */\nexport interface UseBooleanReturn {\n  /** Current boolean value */\n  value: boolean;\n  /** Set value to true */\n  onTrue: () => void;\n  /** Set value to false */\n  onFalse: () => void;\n  /** Toggle the value */\n  onToggle: () => void;\n  /** Set to specific value */\n  setValue: (value: boolean) => void;\n}\n\n/**\n * Hook for managing boolean state with convenient toggle methods.\n *\n * @param defaultValue - Initial boolean value (default: false)\n * @returns Boolean state and control methods\n *\n * @example\n * ```tsx\n * function Modal() {\n *   const dialog = useBoolean();\n *\n *   return (\n *     <>\n *       <Button onClick={dialog.onTrue}>Open</Button>\n *       <Dialog open={dialog.value} onClose={dialog.onFalse}>\n *         <DialogContent>...</DialogContent>\n *       </Dialog>\n *     </>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * function Sidebar() {\n *   const { value: isCollapsed, onToggle } = useBoolean(false);\n *\n *   return (\n *     <nav style={{ width: isCollapsed ? 64 : 240 }}>\n *       <IconButton onClick={onToggle}>\n *         {isCollapsed ? <MenuIcon /> : <CloseIcon />}\n *       </IconButton>\n *     </nav>\n *   );\n * }\n * ```\n */\nexport function useBoolean(defaultValue = false): UseBooleanReturn {\n  const [value, setValue] = useState(defaultValue);\n\n  const onTrue = useCallback(() => {\n    setValue(true);\n  }, []);\n\n  const onFalse = useCallback(() => {\n    setValue(false);\n  }, []);\n\n  const onToggle = useCallback(() => {\n    setValue((prev) => !prev);\n  }, []);\n\n  return useMemo(\n    () => ({\n      value,\n      onTrue,\n      onFalse,\n      onToggle,\n      setValue,\n    }),\n    [value, onTrue, onFalse, onToggle]\n  );\n}\n"]}

package/dist/chunk-JDTC2SBY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/accessibility/skip-link.tsx","../src/core/accessibility/index.ts"],"names":[],"mappings":"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","file":"chunk-JDTC2SBY.js","sourcesContent":["/**\n * Skip Link Component\n *\n * Provides keyboard users a way to skip navigation and jump to main content.\n *\n * @module @omnitron-dev/prism/core/accessibility/skip-link\n */\n\nimport type { ReactNode } from 'react';\nimport Box from '@mui/material/Box';\nimport type { SxProps, Theme } from '@mui/material';\n\n/**\n * Props for SkipLink component.\n */\nexport interface SkipLinkProps {\n  /** Target element ID to skip to */\n  href: string;\n  /** Link content (typically \"Skip to main content\") */\n  children: ReactNode;\n  /** MUI sx prop */\n  sx?: SxProps<Theme>;\n}\n\n/**\n * Skip link that is visually hidden until focused.\n * Allows keyboard users to skip navigation and jump to main content.\n *\n * @example\n * ```tsx\n * <SkipLink href=\"#main-content\">Skip to main content</SkipLink>\n * ```\n */\nexport function SkipLink({ href, children, sx }: SkipLinkProps): ReactNode {\n  return (\n    <Box\n      component=\"a\"\n      href={href}\n      sx={[\n        (theme) => ({\n          position: 'absolute',\n          top: '-100%',\n          left: 0,\n          right: 0,\n          zIndex: theme.zIndex.tooltip + 1,\n          padding: theme.spacing(1, 2),\n          backgroundColor: theme.palette.primary.main,\n          color: theme.palette.primary.contrastText,\n          textAlign: 'center',\n          textDecoration: 'none',\n          fontWeight: theme.typography.fontWeightMedium,\n          fontSize: theme.typography.body2.fontSize,\n          // Show on focus\n          '&:focus': {\n            top: 0,\n            outline: `2px solid ${theme.palette.primary.dark}`,\n            outlineOffset: 2,\n          },\n        }),\n        ...(Array.isArray(sx) ? sx : [sx]),\n      ]}\n    >\n      {children}\n    </Box>\n  );\n}\n","/**\n * Accessibility Utilities\n *\n * WCAG 2.1 compliant accessibility components and utilities.\n *\n * @module @omnitron-dev/prism/core/accessibility\n */\n\nexport { SkipLink } from './skip-link.js';\nexport type { SkipLinkProps } from './skip-link.js';\n\n// =============================================================================\n// ARIA HELPERS\n// =============================================================================\n\n/**\n * Generate ID for accessibility references.\n */\nexport function generateAriaId(prefix: string): string {\n  return `${prefix}-${Math.random().toString(36).slice(2, 9)}`;\n}\n\n/**\n * Combine multiple aria-describedby values.\n */\nexport function combineAriaDescribedBy(...ids: (string | undefined)[]): string | undefined {\n  const validIds = ids.filter(Boolean);\n  return validIds.length > 0 ? validIds.join(' ') : undefined;\n}\n\n/**\n * Screen reader only styles (visually hidden but accessible).\n */\nexport const srOnly = {\n  position: 'absolute' as const,\n  width: '1px',\n  height: '1px',\n  padding: 0,\n  margin: '-1px',\n  overflow: 'hidden',\n  clip: 'rect(0, 0, 0, 0)',\n  whiteSpace: 'nowrap' as const,\n  border: 0,\n};\n\n/**\n * Focus visible styles for keyboard navigation.\n */\nexport const focusVisibleStyles = (theme: { palette: { primary: { main: string } } }) => ({\n  '&:focus-visible': {\n    outline: `2px solid ${theme.palette.primary.main}`,\n    outlineOffset: 2,\n  },\n});\n\n// =============================================================================\n// KEYBOARD NAVIGATION HELPERS\n// =============================================================================\n\n/**\n * Handle keyboard navigation for list items.\n */\nexport function handleListKeyDown(\n  event: React.KeyboardEvent,\n  options: {\n    items: HTMLElement[];\n    currentIndex: number;\n    onSelect?: (index: number) => void;\n    orientation?: 'vertical' | 'horizontal';\n  }\n): void {\n  const { items, currentIndex, onSelect, orientation = 'vertical' } = options;\n\n  const nextKey = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';\n  const prevKey = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';\n\n  let newIndex: number;\n\n  switch (event.key) {\n    case nextKey:\n      event.preventDefault();\n      newIndex = Math.min(currentIndex + 1, items.length - 1);\n      break;\n    case prevKey:\n      event.preventDefault();\n      newIndex = Math.max(currentIndex - 1, 0);\n      break;\n    case 'Home':\n      event.preventDefault();\n      newIndex = 0;\n      break;\n    case 'End':\n      event.preventDefault();\n      newIndex = items.length - 1;\n      break;\n    case 'Enter':\n    case ' ':\n      event.preventDefault();\n      onSelect?.(currentIndex);\n      return;\n    default:\n      return;\n  }\n\n  if (newIndex !== currentIndex && items[newIndex]) {\n    items[newIndex].focus();\n  }\n}\n\n// =============================================================================\n// LANDMARK ROLES\n// =============================================================================\n\n/**\n * Standard ARIA landmark labels.\n */\nexport const ARIA_LABELS = {\n  /** Main navigation */\n  mainNav: 'Main navigation',\n  /** Secondary navigation */\n  secondaryNav: 'Secondary navigation',\n  /** Search */\n  search: 'Search',\n  /** Main content */\n  main: 'Main content',\n  /** Header */\n  header: 'Header',\n  /** Footer */\n  footer: 'Footer',\n  /** Sidebar */\n  sidebar: 'Sidebar',\n  /** Breadcrumb navigation */\n  breadcrumb: 'Breadcrumb navigation',\n  /** User menu */\n  userMenu: 'User menu',\n  /** Settings */\n  settings: 'Settings',\n} as const;\n\n/**\n * Common ARIA expanded patterns.\n */\nexport interface AriaExpandedProps {\n  'aria-expanded': boolean;\n  'aria-controls'?: string;\n}\n\n/**\n * Get aria-expanded props.\n */\nexport function getAriaExpanded(expanded: boolean, controlsId?: string): AriaExpandedProps {\n  return {\n    'aria-expanded': expanded,\n    ...(controlsId && { 'aria-controls': controlsId }),\n  };\n}\n\n// =============================================================================\n// LIVE REGION HELPERS\n// =============================================================================\n\n/**\n * Announce message to screen readers.\n */\nexport function announceToScreenReader(message: string, priority: 'polite' | 'assertive' = 'polite'): void {\n  const announcement = document.createElement('div');\n  announcement.setAttribute('role', 'status');\n  announcement.setAttribute('aria-live', priority);\n  announcement.setAttribute('aria-atomic', 'true');\n  Object.assign(announcement.style, srOnly);\n  announcement.textContent = message;\n\n  document.body.appendChild(announcement);\n\n  // Remove after announcement is read\n  setTimeout(() => {\n    document.body.removeChild(announcement);\n  }, 1000);\n}\n"]}