@mhmo91/schmancy 0.8.6 → 0.9.2

package/ai/animated-text.md

@@ -1,116 +0,0 @@
-# Schmancy Animated Text - AI Reference
-
-```js
-// Animated Text Component
-<schmancy-animated-text
-  ease="outExpo"
-  delay="0"
-  stagger="50"
-  duration="750"
-  scale="[0, 1]"
-  opacity="[0, 1]"
-  translateX="['0.55em', '0em']"
-  translateY="['1.1em', '0em']"
-  rotate3d="[0, 0, 1, 45]">
-  Text to animate
-</schmancy-animated-text>
-
-// Animation Properties
-ease: string           // Animation easing function (default: "outExpo")
-delay: number          // Initial delay in milliseconds (default: 0)
-stagger: number        // Delay between letter animations (default: 50)
-duration: number       // Animation duration in milliseconds (default: 750)
-scale: number[]        // Scale transformation [from, to] (default: [0, 1])
-opacity: number[]      // Opacity transition [from, to] (default: [0, 1])
-translateX: string[]   // X translation ["from", "to"] (default: ['0.55em', '0em'])
-translateY: string[]   // Y translation ["from", "to"] (default: ['1.1em', '0em'])
-rotate3d: number[]     // 3D rotation [x, y, z, angle] (default: [0, 0, 1, 45])
-
-// Examples
-// 1. Basic fade in
-<schmancy-animated-text>
-  Welcome to our application
-</schmancy-animated-text>
-
-// 2. Custom stagger effect
-<schmancy-animated-text
-  stagger="100"
-  duration="1000"
-  translateY="['2em', '0em']">
-  Cascading Letters
-</schmancy-animated-text>
-
-// 3. Scale and rotate effect
-<schmancy-animated-text
-  scale="[0.5, 1]"
-  rotate3d="[0, 1, 0, 180]"
-  duration="1500">
-  Dramatic Entrance
-</schmancy-animated-text>
-
-// 4. No translation effect
-<schmancy-animated-text
-  translateX="['0em', '0em']"
-  translateY="['0em', '0em']"
-  opacity="[0, 1]">
-  Fade Only
-</schmancy-animated-text>
-```
-
-## Related Components
-
-- **[Typography](./typography.md)**: Base text styling component
-- **[Typewriter](./typewriter.md)**: Alternative text animation with typing effect
-
-## Technical Details
-
-### Animation Behavior
-
-- Text is split into individual letter spans
-- Each letter animates with the specified stagger delay
-- Uses Web Animations API for performance
-- Animations trigger on component mount and when text changes
-- Responsive to viewport visibility
-
-### CSS Classes
-- `.ml7`: Main wrapper class
-- `.text-wrapper`: Container for animated text
-- `.letter`: Individual animated letter span
-
-## Common Use Cases
-
-1. **Hero Text**: Large headings with dramatic entrance animations
-   ```html
-   <h1>
-     <schmancy-animated-text duration="2000" scale="[0.3, 1]">
-       Welcome to Schmancy
-     </schmancy-animated-text>
-   </h1>
-   ```
-
-2. **Loading Messages**: Staggered letter animations for loading states
-   ```html
-   <schmancy-animated-text stagger="100" translateY="['1em', '0em']">
-     Loading...
-   </schmancy-animated-text>
-   ```
-
-3. **Notifications**: Subtle fade-in for status messages
-   ```html
-   <schmancy-animated-text 
-     duration="500" 
-     translateX="['0em', '0em']"
-     translateY="['0em', '0em']">
-     Operation completed successfully
-   </schmancy-animated-text>
-   ```
-
-4. **Interactive Reveals**: Combined with visibility triggers
-   ```html
-   <schmancy-animated-text 
-     delay="500"
-     stagger="75"
-     opacity="[0, 1]">
-     Scroll to reveal this text
-   </schmancy-animated-text>
-   ```

package/ai/audio.md

@@ -1,241 +0,0 @@
-# Schmancy Emotional Sound Library - AI Reference
-
-## Overview
-
-A curated collection of soft, elegant sounds organized by emotional categories. Each sound is designed to be non-intrusive, emotionally evocative, and beautiful - inspired by the gentle sounds of nature like soft air puffs and warm tones.
-
-## Quick Start
-
-```typescript
-// Import from the main Schmancy package
-import { $sounds } from '@mhmo91/schmancy'
-
-// Play a feeling
-$sounds.play('joyful')
-$sounds.play('relieved')
-$sounds.play('curious')
-
-// Adjust volume (0.0 - 1.0)
-$sounds.setVolume(0.2)
-
-// Mute/unmute
-$sounds.mute()
-$sounds.unmute()
-```
-
-## Feeling Categories
-
-### 1. Happy / Pleasant
-```typescript
-type HappyFeeling =
-  | 'joyful' | 'content' | 'excited' | 'proud' | 'hopeful'
-  | 'relieved' | 'grateful' | 'peaceful' | 'playful' | 'amused'
-  | 'curious' | 'inspired' | 'confident' | 'loved' | 'comforted' | 'energized'
-
-// Examples
-$sounds.play('joyful')     // Double puff + rising happy tones
-$sounds.play('content')    // Gentle satisfied sigh + warm tones
-$sounds.play('excited')    // Quick ascending puffs + sparkly tones
-$sounds.play('curious')    // Questioning puff + rising tone
-$sounds.play('relieved')   // Long exhale + descending release
-```
-
-### 2. Sad / Low
-```typescript
-type SadFeeling =
-  | 'sad' | 'lonely' | 'disappointed' | 'heartbroken' | 'grieving'
-  | 'hopeless' | 'empty' | 'discouraged' | 'melancholic' | 'homesick'
-  | 'hurt' | 'miserable' | 'regretful' | 'ashamed' | 'inferior'
-
-// Examples
-$sounds.play('sad')           // Heavy sigh + descending tone
-$sounds.play('disappointed')  // Deflating puff + falling tone
-$sounds.play('melancholic')   // Wistful puff + bittersweet tones
-```
-
-### 3. Anxious / Fearful
-```typescript
-type AnxiousFeeling =
-  | 'anxious' | 'worried' | 'afraid' | 'terrified' | 'panicked'
-  | 'nervous' | 'uneasy' | 'insecure' | 'overwhelmed' | 'stressed'
-  | 'tense' | 'apprehensive' | 'startled' | 'suspicious' | 'vulnerable'
-
-// Examples
-$sounds.play('anxious')   // Tight quick puffs + uncertain wobble
-$sounds.play('nervous')   // Quick shallow puffs + trembling tone
-$sounds.play('startled')  // Quick sharp puff + high tone
-```
-
-### 4. Angry / Frustrated
-```typescript
-type AngryFeeling =
-  | 'annoyed' | 'irritated' | 'frustrated' | 'angry' | 'enraged'
-  | 'bitter' | 'resentful' | 'jealous' | 'envious' | 'indignant'
-  | 'impatient' | 'hostile' | 'contemptuous'
-
-// Examples
-$sounds.play('annoyed')     // Short frustrated puff + low rumble
-$sounds.play('frustrated')  // Tense puff + blocked feeling
-$sounds.play('impatient')   // Quick tapping puffs + urgent tone
-```
-
-### 5. Tired / Drained
-```typescript
-type TiredFeeling =
-  | 'tired' | 'exhausted' | 'drained' | 'burnedOut' | 'numb'
-  | 'bored' | 'unmotivated' | 'apathetic' | 'restless'
-
-// Examples
-$sounds.play('tired')     // Heavy slow puff + drooping tone
-$sounds.play('exhausted') // Very slow heavy exhale + descending fade
-$sounds.play('bored')     // Flat sigh + monotone
-```
-
-### 6. Calm / Grounded
-```typescript
-type CalmFeeling =
-  | 'calm' | 'relaxed' | 'atEase' | 'balanced' | 'stable'
-  | 'secure' | 'safe' | 'centered' | 'grounded' | 'accepting'
-
-// Examples
-$sounds.play('calm')      // Slow peaceful puff + sustained gentle tone
-$sounds.play('relaxed')   // Long soft exhale + gentle descending
-$sounds.play('grounded')  // Deep centered puff + low stable tone
-$sounds.play('safe')      // Soft enveloping puff + warm embracing tones
-```
-
-### 7. Connected / Social
-```typescript
-type ConnectedFeeling =
-  | 'connected' | 'accepted' | 'included' | 'belonging' | 'appreciated'
-  | 'valued' | 'respected' | 'supported' | 'protective' | 'compassionate' | 'empathetic'
-
-// Examples
-$sounds.play('connected')   // Warm shared breath + harmonious tones
-$sounds.play('appreciated') // Touched puff + warm ascending
-$sounds.play('supported')   // Held puff + stable harmonies
-```
-
-### 8. Mixed / Complicated
-```typescript
-type MixedFeeling =
-  | 'conflicted' | 'confused' | 'ambivalent' | 'nostalgic' | 'guilty'
-  | 'embarrassed' | 'surprised' | 'shocked' | 'awestruck' | 'skeptical'
-
-// Examples
-$sounds.play('nostalgic')  // Wistful distant puff + bittersweet memory tones
-$sounds.play('surprised')  // Quick gasp + rising tone
-$sounds.play('awestruck')  // Wonder-filled breath + ascending shimmer
-$sounds.play('confused')   // Uncertain puff + questioning wobble
-```
-
-## API Reference
-
-```typescript
-class EmotionalSoundGenerator {
-  // Play any feeling
-  play(feeling: Feeling): void
-
-  // Volume control (0.0 - 1.0, default 0.15)
-  setVolume(vol: number): void
-  getVolume(): number
-
-  // Mute control
-  mute(): void
-  unmute(): void
-  isMuted(): boolean
-
-  // Cleanup
-  dispose(): void
-}
-
-// Singleton instance
-export const $sounds: EmotionalSoundGenerator
-```
-
-## Sound Design Philosophy
-
-All sounds are built from these core primitives:
-
-1. **Puff** - Filtered white noise creating soft air sounds
-2. **Tone** - Simple sine wave with gentle envelope
-3. **Warm Tone** - Low-pass filtered tone for warmth
-4. **Shimmer** - Multiple harmonically related tones
-
-Each feeling combines these primitives with:
-- Quick attack (15-30ms) for responsiveness
-- Gentle exponential release for softness
-- Low default volume (0.15) for subtlety
-- Short duration (0.2-0.5s) for non-intrusiveness
-
-## Use Cases
-
-```typescript
-// Form validation feedback
-onValidationError() {
-  $sounds.play('disappointed')
-}
-
-onValidationSuccess() {
-  $sounds.play('relieved')
-}
-
-// User actions
-onSaveComplete() {
-  $sounds.play('content')
-}
-
-onDelete() {
-  $sounds.play('sad')
-}
-
-// Navigation
-onPageLoad() {
-  $sounds.play('curious')
-}
-
-// Achievements
-onMilestoneReached() {
-  $sounds.play('proud')
-}
-
-// Connections
-onFriendJoined() {
-  $sounds.play('connected')
-}
-
-// Waiting states
-onLoadingTimeout() {
-  $sounds.play('impatient')
-}
-```
-
-## Type Exports
-
-```typescript
-import type {
-  Feeling,
-  FeelingCategory,
-  HappyFeeling,
-  SadFeeling,
-  AnxiousFeeling,
-  AngryFeeling,
-  TiredFeeling,
-  CalmFeeling,
-  ConnectedFeeling,
-  MixedFeeling,
-} from '@mhmo91/schmancy'
-```
-
-## All 88 Feelings at a Glance
-
-| Category | Feelings |
-|----------|----------|
-| **Happy** | joyful, content, excited, proud, hopeful, relieved, grateful, peaceful, playful, amused, curious, inspired, confident, loved, comforted, energized |
-| **Sad** | sad, lonely, disappointed, heartbroken, grieving, hopeless, empty, discouraged, melancholic, homesick, hurt, miserable, regretful, ashamed, inferior |
-| **Anxious** | anxious, worried, afraid, terrified, panicked, nervous, uneasy, insecure, overwhelmed, stressed, tense, apprehensive, startled, suspicious, vulnerable |
-| **Angry** | annoyed, irritated, frustrated, angry, enraged, bitter, resentful, jealous, envious, indignant, impatient, hostile, contemptuous |
-| **Tired** | tired, exhausted, drained, burnedOut, numb, bored, unmotivated, apathetic, restless |
-| **Calm** | calm, relaxed, atEase, balanced, stable, secure, safe, centered, grounded, accepting |
-| **Connected** | connected, accepted, included, belonging, appreciated, valued, respected, supported, protective, compassionate, empathetic |
-| **Mixed** | conflicted, confused, ambivalent, nostalgic, guilty, embarrassed, surprised, shocked, awestruck, skeptical |

package/ai/boat.md

@@ -1,53 +0,0 @@
-# schmancy-boat
-
-
-Floating, draggable bottom sheet component with three states: `hidden`, `minimized`, `expanded`.
-
-## API
-
-```typescript
-state: 'hidden' | 'minimized' | 'expanded'  // Current state
-id: string                                   // Unique ID for position persistence
-icon?: string                                // Material icon name
-label?: string                               // Header text
-badge?: string | number                      // Notification badge
-lowered?: boolean                            // Reduced shadow elevation
-
-// Methods
-toggleState()  // Toggle minimized ↔ expanded
-close()        // Hide and add to navigation
-
-// Events
-@toggle  // CustomEvent<'hidden' | 'minimized' | 'expanded'>
-```
-
-## Usage
-
-```html
-<!-- Basic -->
-<schmancy-boat
-  id="chat"
-  icon="chat"
-  label="Support"
-  badge="3"
-  state="minimized"
-  @toggle=${e => this.state = e.detail}
->
-  <div class="p-6">Content here</div>
-</schmancy-boat>
-```
-
-## Critical Rules
-
-- ✅ **ALWAYS** provide unique `id` (position persists to localStorage)
-- ✅ **ALWAYS** use `icon`, `label`, `badge` properties (NOT `slot="header"`)
-- ✅ **REQUIRES** content in default slot
-- ❌ **NEVER** self-closing
-- ❌ **NEVER** use deprecated `slot="header"`
-
-## Features
-
-- **Draggable**: Drag header to reposition, position saved to localStorage
-- **Responsive**: Auto-adjusts width (mobile: full, desktop: 40vw)
-- **Keyboard**: `Escape` to minimize/hide
-- **Navigation**: Close button adds to nav rail/bar if available

package/ai/component-relationships.md

@@ -1,93 +0,0 @@
-# Schmancy Component Relationships
-
-This document maps the relationships between Schmancy components to provide a holistic understanding of the library.
-
-## Component Categories
-
-### Core Infrastructure
-- **Area**: Routing and application area management
-- **Store**: State management system
-- **Teleport**: Component transportation across DOM
-- **RxJS Utils**: Reactive programming utilities
-
-### Layout Components
-- **Layout**: Container layout (flex, grid)
-- **Surface**: Style-able container with consistent theming
-- **Card**: Content containers with various layouts
-- **Divider**: Visual separation element
-
-### Navigation & Structure
-- **Tabs**: Tabbed interface components
-- **Menu**: Dropdown/contextual menus
-- **Nav-Drawer**: Navigation drawer with app bar
-- **Content-Drawer**: Side panel content drawers
-- **Sheet**: Modal slide-up panels
-- **Dialog**: Modal dialog boxes
-
-### Form Controls
-- **Form**: Form container with validation
-- **Input**: Text input fields
-- **Textarea**: Multi-line text input
-- **Select**: Dropdown selection
-- **Autocomplete**: Text input with suggestions
-- **Checkbox**: Boolean selection control
-- **Radio-Group**: Exclusive option selection
-- **Option**: Selection option item
-
-### Interactive Elements
-- **Button**: Action triggers (primary, secondary, tertiary)
-- **Dropdown**: Togglable content containers
-- **Chips**: Compact interactive elements
-- **List**: Interactive list items
-- **Tree**: Hierarchical data display
-- **Table**: Tabular data display
-
-### Feedback & Status
-- **Notification**: Toast messages and alerts
-- **Tooltip**: Contextual information on hover
-- **Badge**: Numeric/status indicators
-- **Busy**: Loading indicators
-- **Avatar**: User/entity visual representation
-
-### Typography & Visual
-- **Typography**: Text styling system
-- **Icons**: Iconography system
-- **Animated-Text**: Text animation utilities
-- **Typewriter**: Typing animation effect
-
-### Utilities
-- **Directives**: DOM behavior extensions
-- **Theme**: Theming system
-- **Theme-Button**: Theme toggle control
-- **Utils**: General utility functions
-- **Types**: TypeScript type definitions
-- **Delay**: Timing utilities
-- **Date-Range**: Date selection utilities
-- **Steps**: Multi-step process visualization
-
-## Key Component Interactions
-
-### Form System Interactions
-- **Form** → Contains and validates: Input, Textarea, Select, Checkbox, Radio-Group
-- **Input/Select/Autocomplete** → Can contain: Icons
-- **Option** → Used by: Select, Autocomplete
-
-### Layout System Interactions
-- **Surface** → Used by: Card, Dialog, Sheet, Table
-- **Layout** → Container for: most visible components
-- **Card** → Contains: Card-Media, Card-Content, Card-Actions
-
-### Navigation System Interactions
-- **Area** → Controls routing for: any component
-- **Tabs** → Contains: Tab components
-- **Nav-Drawer** → Contains: AppBar, Drawer, Content
-- **Content-Drawer** → Specialized Sheet with context
-
-### State Management
-- **Store** → Can be used with: any component
-- **Area** → Manages routing state via reactive observables
-
-### Notification System
-- **Notification** → Uses: Surface
-- **Dialog** → Uses: Surface
-- **Tooltip** → Can attach to: any component