@lukeashford/aurelius 1.0.0 → 1.1.0

package/dist/llms.md

@@ -1,325 +0,0 @@
-# Aurelius Design System Philosophy
-
-## Core Principles
-Aurelius is a design system for creative technologists, blending technical sophistication with an artistic, cinematic aesthetic. The visual language relies on deep blacks, rich golds, and refined typography to convey stability, trust, and quiet luxury.
-
-## Implementation Strategy
-**Hierarchy:** React Components > Component Classes > Utility Classes > Design Tokens.
-
-1.  **React Components:** Use exported components (e.g., `<Button />`) whenever possible.
-2.  **Component Classes:** Fallback to semantic CSS classes (e.g., `.btn`) if no React component fits.
-3.  **Utility Classes:** Build custom elements using Tailwind utilities with semantic tokens (e.g., `bg-obsidian`).
-4.  **Design Tokens:** Use raw tokens only as a last resort.
-
-## Visual Guidelines
-*   **Theme:** Strictly dark mode. Avoid white backgrounds for containers; use `obsidian` (#0a0a0a) or `charcoal` (#141414).
-*   **Typography:** Use the system font stack via our utility classes. Do not introduce external fonts unless specified.
-*   **Borders:** Prefer subtle 1px borders (`border-ash`) over heavy drop shadows.
-*   **Primary Color:** Gold (#c9a227) is reserved for primary actions and key highlights.
-
-**Instruction for AI Agents:**
-Before generating code, verify if an existing component in this package meets the requirement. Hallucinating new styles for standard elements is strictly prohibited. Check the Manifest below for available tools.
-
-
-## React Components API
-
-### <Alert />
-**Props:**
-- `variant?: AlertVariant`
-- `title?: string`
-
-### <Avatar />
-**Props:**
-- `src?: string`
-- `alt?: string`
-- `name?: string`
-- `size?: AvatarSize`
-- `status?: 'online' | 'offline' | 'busy'`
-
-### <Badge />
-**Props:**
-- `variant?: BadgeVariant`
-
-### <Button />
-**Props:**
-- `variant?: ButtonVariant`
-- `size?: ButtonSize`
-- `loading?: boolean`
-
-### <Card />
-**Props:**
-- `variant?: CardVariant`
-- `interactive?: boolean`
-
-### <Checkbox />
-**Props:**
-- `label?: string`
-
-### <HelperText />
-**Props:**
-- `error?: boolean`
-
-### <Input />
-**Props:**
-- `error?: boolean`
-- `leadingIcon?: React.ReactNode`
-- `trailingIcon?: React.ReactNode`
-
-### <Label />
-**Props:**
-- `required?: boolean`
-
-### <Modal />
-**Props:**
-- `isOpen: boolean`
-- `onClose: () => void`
-- `title?: string`
-- `children: React.ReactNode`
-- `className?: string`
-
-### <Radio />
-**Props:**
-- `label?: string`
-
-### <Select />
-**Props:**
-- `error?: boolean`
-- `options?: SelectOption[]`
-
-### <Skeleton />
-
-### <Spinner />
-**Props:**
-- `size?: 'sm' | 'md' | 'lg'`
-
-### <Switch />
-**Props:**
-- `checked?: boolean`
-- `defaultChecked?: boolean`
-- `onCheckedChange?: (checked: boolean) => void`
-- `label?: string`
-
-### <Textarea />
-**Props:**
-- `error?: boolean`
-
-### <Tooltip />
-**Props:**
-- `content: React.ReactNode`
-- `children: React.ReactElement`
-- `open?: boolean`
-- `side?: 'top' | 'right' | 'bottom' | 'left'`
-
-## CSS Classes & Tailwind Utilities
-
-### Component Classes
-
-| Class | Description |
-|---|---|
-| `.alert` | |
-| `.alert-error` | |
-| `.alert-info` | |
-| `.alert-success` | |
-| `.alert-warning` | |
-| `.avatar` | |
-| `.avatar-2xl` | |
-| `.avatar-lg` | |
-| `.avatar-md` | |
-| `.avatar-sm` | |
-| `.avatar-xl` | |
-| `.avatar-xs` | |
-| `.badge` | |
-| `.badge-default` | |
-| `.badge-error` | |
-| `.badge-gold` | |
-| `.badge-info` | |
-| `.badge-success` | |
-| `.badge-warning` | |
-| `.btn` | |
-| `.btn-danger` | |
-| `.btn-elevated` | |
-| `.btn-featured` | |
-| `.btn-ghost` | |
-| `.btn-important` | |
-| `.btn-lg` | |
-| `.btn-md` | |
-| `.btn-outlined` | |
-| `.btn-primary` | |
-| `.btn-sm` | |
-| `.btn-xl` | |
-| `.card` | |
-| `.card-elevated` | |
-| `.card-featured` | |
-| `.card-interactive` | |
-| `.card-outlined` | |
-| `.checkbox` | |
-| `.divider` | |
-| `.divider-vertical` | |
-| `.input` | |
-| `.input-error` | |
-| `.label` | |
-| `.label-required` | |
-| `.modal-backdrop` | |
-| `.modal-content` | |
-| `.radio` | |
-| `.select` | |
-| `.switch` | |
-| `.switch-thumb` | |
-| `.textarea` | |
-| `.textarea-error` | |
-| `.tooltip` | |
-
-### Utility Classes
-
-| Class | Description |
-|---|---|
-| `.backdrop-glass` | |
-| `.center-absolute` | |
-| `.focus-ring` | |
-| `.glow` | |
-| `.glow-lg` | |
-| `.glow-sm` | |
-| `.line-clamp-2` | |
-| `.line-clamp-3` | |
-| `.scroll-smooth` | |
-| `.scrollbar-hide` | |
-| `.text-gradient-gold` | |
-| `.truncate` | |
-
-## Design Tokens
-
-### Colors
-
-| Token | Value |
-|---|---|
-| `colors.void` | #000000 |
-| `colors.obsidian` | #0a0a0a |
-| `colors.charcoal` | #141414 |
-| `colors.graphite` | #1f1f1f |
-| `colors.slate` | #2a2a2a |
-| `colors.ash` | #3d3d3d |
-| `colors.gold` | #c9a227 |
-| `colors.goldLight` | #d4b84a |
-| `colors.goldBright` | #e5c84d |
-| `colors.goldMuted` | #8b7355 |
-| `colors.goldPale` | #d4c4a8 |
-| `colors.goldGlow` | rgba(201, 162, 39, 0.15) |
-| `colors.white` | #ffffff |
-| `colors.silver` | #a3a3a3 |
-| `colors.zinc` | #71717a |
-| `colors.dim` | #52525b |
-| `colors.success` | #22c55e |
-| `colors.successMuted` | #166534 |
-| `colors.error` | #dc2626 |
-| `colors.errorMuted` | #991b1b |
-| `colors.warning` | #d97706 |
-| `colors.warningMuted` | #92400e |
-| `colors.info` | #0ea5e9 |
-| `colors.infoMuted` | #0369a1 |
-
-### Duration
-
-| Token | Value |
-|---|---|
-| `duration.instant` | 75ms |
-| `duration.fast` | 150ms |
-| `duration.normal` | 200ms |
-| `duration.slow` | 300ms |
-| `duration.slower` | 500ms |
-
-### Easing
-
-| Token | Value |
-|---|---|
-| `easing.smooth` | cubic-bezier(0.16, 1, 0.3, 1) |
-| `easing.snap` | cubic-bezier(0.5, 0, 0.1, 1) |
-
-### Radii
-
-| Token | Value |
-|---|---|
-| `radii.sm` | 0.125rem |
-| `radii.md` | 0.25rem |
-| `radii.lg` | 0.375rem |
-| `radii.xl` | 0.5rem |
-| `radii.2xl` | 0.75rem |
-| `radii.3xl` | 1rem |
-| `radii.full` | 9999px |
-
-### Shadows
-
-| Token | Value |
-|---|---|
-| `shadows.sm` | 0 1px 2px 0 rgba(0, 0, 0, 0.4) |
-| `shadows.md` | 0 4px 6px -1px rgba(0, 0, 0, 0.4), 0 2px 4px -2px rgba(0, 0, 0, 0.3) |
-| `shadows.lg` | 0 10px 15px -3px rgba(0, 0, 0, 0.4), 0 4px 6px -4px rgba(0, 0, 0, 0.3) |
-| `shadows.xl` | 0 20px 25px -5px rgba(0, 0, 0, 0.4), 0 8px 10px -6px rgba(0, 0, 0, 0.3) |
-| `shadows.2xl` | 0 25px 50px -12px rgba(0, 0, 0, 0.5) |
-| `shadows.glow` | 0 0 20px rgba(201, 162, 39, 0.3) |
-| `shadows.glow-sm` | 0 0 10px rgba(201, 162, 39, 0.2) |
-| `shadows.glow-lg` | 0 0 40px rgba(201, 162, 39, 0.4) |
-| `shadows.inner` | inset 0 2px 4px 0 rgba(0, 0, 0, 0.3) |
-
-### Spacing
-
-| Token | Value |
-|---|---|
-| `spacing.0` | 0 |
-| `spacing.1` | 0.25rem |
-| `spacing.2` | 0.5rem |
-| `spacing.3` | 0.75rem |
-| `spacing.4` | 1rem |
-| `spacing.5` | 1.25rem |
-| `spacing.6` | 1.5rem |
-| `spacing.7` | 1.75rem |
-| `spacing.8` | 2rem |
-| `spacing.9` | 2.25rem |
-| `spacing.10` | 2.5rem |
-| `spacing.11` | 2.75rem |
-| `spacing.12` | 3rem |
-| `spacing.14` | 3.5rem |
-| `spacing.16` | 4rem |
-| `spacing.20` | 5rem |
-| `spacing.24` | 6rem |
-| `spacing.28` | 7rem |
-| `spacing.32` | 8rem |
-| `spacing.px` | 1px |
-| `spacing.0.5` | 0.125rem |
-| `spacing.1.5` | 0.375rem |
-| `spacing.2.5` | 0.625rem |
-| `spacing.3.5` | 0.875rem |
-
-### Typography
-
-| Token | Value |
-|---|---|
-| `typography.fontHeading` | [Marcellus, serif] |
-| `typography.fontBody` | [Raleway, system-ui, sans-serif] |
-| `typography.fontMono` | [JetBrains Mono, Fira Code, SF Mono, monospace] |
-| `typography.fontSize.xs` | [0.75rem, {"lineHeight":"1rem"}] |
-| `typography.fontSize.sm` | [0.875rem, {"lineHeight":"1.25rem"}] |
-| `typography.fontSize.base` | [1rem, {"lineHeight":"1.5rem"}] |
-| `typography.fontSize.lg` | [1.125rem, {"lineHeight":"1.75rem"}] |
-| `typography.fontSize.xl` | [1.25rem, {"lineHeight":"1.75rem"}] |
-| `typography.fontSize.2xl` | [1.5rem, {"lineHeight":"2rem"}] |
-| `typography.fontSize.3xl` | [1.875rem, {"lineHeight":"2.25rem"}] |
-| `typography.fontSize.4xl` | [2.25rem, {"lineHeight":"2.5rem"}] |
-| `typography.fontSize.5xl` | [3rem, {"lineHeight":"1"}] |
-| `typography.fontSize.6xl` | [3.75rem, {"lineHeight":"1"}] |
-| `typography.fontWeight.normal` | 400 |
-| `typography.fontWeight.medium` | 500 |
-| `typography.fontWeight.semibold` | 600 |
-| `typography.fontWeight.bold` | 700 |
-| `typography.lineHeight.none` | 1 |
-| `typography.lineHeight.tight` | 1.25 |
-| `typography.lineHeight.snug` | 1.375 |
-| `typography.lineHeight.normal` | 1.5 |
-| `typography.lineHeight.relaxed` | 1.625 |
-| `typography.lineHeight.loose` | 2 |
-| `typography.letterSpacing.tighter` | -0.05em |
-| `typography.letterSpacing.tight` | -0.025em |
-| `typography.letterSpacing.normal` | 0 |
-| `typography.letterSpacing.wide` | 0.025em |
-| `typography.letterSpacing.wider` | 0.05em |
-| `typography.letterSpacing.widest` | 0.1em |
-