@churchapps/apphelper 0.4.12 → 0.4.18

package/CHUMS_COMPONENT_EXTRACTION_CANDIDATES.md

@@ -1,210 +0,0 @@
-# ChumsApp Component Extraction Candidates
-
-Generated on: 2025-07-04
-
-## Executive Summary
-
-This document identifies AppHelper components that are only used by ChumsApp and recommends their extraction to reduce AppHelper's scope and improve architectural separation. The analysis focuses on components that represent CHUMS-specific business logic rather than general church management functionality.
-
-## Extraction Candidates
-
-### 🟢 Strong Candidates for Extraction
-
-#### 1. Person Management Components
-**Components**: `PersonAdd`, `CreatePerson`
-**Used by**: ChumsApp only
-**Size**: 2 components
-
-**Business Logic**:
-- Person search and addition to groups/households
-- CHUMS-specific membership management workflows
-- Integration with MembershipApi for person operations
-- Group-specific filtering and validation logic
-
-**Benefits of Extraction**:
-- Moves CHUMS-specific membership logic to CHUMS
-- Reduces AppHelper's dependency on MembershipApi patterns
-- Allows CHUMS team to iterate on person management independently
-
-**Migration Effort**: Low - self-contained components with minimal dependencies
-
----
-
-#### 2. Complete Donation Management System
-**Components**: 
-- `DonationPage` (main donation interface)
-- `FundDonations` (fund management)
-- `FundDonation` (individual fund component)
-- All components in `/donationComponents/`:
-  - `DonationForm`, `NonAuthDonation`, `NonAuthDonationInner`
-  - `PaymentMethods`, `RecurringDonations`, `RecurringDonationsEdit`
-  - `BankForm`, `CardForm`, `FormCardPayment`
-  - `DonationPreviewModal`
-
-**Used by**: ChumsApp only (B1App uses different donation components)
-**Size**: ~13 components + entire donation module
-
-**Business Logic**:
-- Complete Stripe payment processing workflow
-- Recurring donation management
-- Fund-based donation allocation
-- CHUMS-specific donation reporting and history
-- Payment method management and storage
-
-**Benefits of Extraction**:
-- **Massive size reduction** for AppHelper (removes entire donation module)
-- Eliminates Stripe dependencies from AppHelper
-- Allows CHUMS-specific donation features without affecting other apps
-- Reduces bundle size for non-donation apps (B1App, LessonsApp)
-- Cleaner separation between different donation workflows (CHUMS vs B1)
-
-**Migration Effort**: Medium - requires moving entire module and updating imports
-
----
-
-### 🟡 Moderate Candidates (Recommend Keeping)
-
-#### 3. Notes/Messaging System
-**Components**: `Notes`, `Note`, `AddNote`, `Conversation`, `Conversations`, `NewConversation`
-**Used by**: ChumsApp only currently
-**Size**: 6 components
-
-**Analysis**:
-- **Business Logic**: Generic messaging/conversation functionality
-- **API Integration**: Uses MessagingApi (separate microservice)
-- **Reusability**: High potential for use by other church apps
-- **Current State**: Only used by CHUMS but architecturally generic
-
-**Recommendation**: **Keep in AppHelper**
-**Reasoning**: Messaging is a universal need across church applications. The MessagingApi already provides good separation of concerns.
-
----
-
-#### 4. Reporting Infrastructure
-**Components**: `ReportWithFilter`, `ReportFilter`, `ReportFilterField`, `ReportOutput`, `ChartReport`, `TableReport`, `TreeReport`
-**Used by**: ChumsApp only currently  
-**Size**: 7 components
-
-**Analysis**:
-- **Business Logic**: Generic reporting with filtering capabilities
-- **API Integration**: Uses ReportingApi (separate microservice)
-- **Reusability**: High potential for other apps' reporting needs
-- **Architecture**: Well-abstracted reporting infrastructure
-
-**Recommendation**: **Keep in AppHelper**
-**Reasoning**: Reporting is universal church management functionality that other apps will likely need.
-
----
-
-## Impact Analysis
-
-### AppHelper Size Reduction
-- **Total components to extract**: 15 components (PersonAdd/CreatePerson + entire donation system)
-- **Percentage reduction**: ~29% of total components (15 out of 51)
-- **Bundle size impact**: Significant reduction due to removal of Stripe and donation logic
-
-### Dependency Cleanup
-**Dependencies to remove from AppHelper**:
-- Stripe payment processing libraries
-- CHUMS-specific MembershipApi patterns
-- Donation-related TypeScript interfaces
-- Payment method validation logic
-
-### Breaking Changes
-**Projects affected**: ChumsApp only
-**Migration required**: 
-- Update imports in ChumsApp
-- Move components to ChumsApp's component directory
-- Update build processes to include new components
-
----
-
-## Recommended Extraction Strategy
-
-### Phase 1: Donation System Migration
-1. **Create donation module in ChumsApp**
-   - Copy all donation components to `src/donationComponents/`
-   - Update internal imports to use local components
-   - Test donation functionality in ChumsApp
-
-2. **Update ChumsApp imports**
-   - Replace `@churchapps/apphelper` donation imports with local imports
-   - Verify all donation workflows still function
-
-3. **Remove from AppHelper**
-   - Delete donation components from AppHelper
-   - Remove Stripe dependencies
-   - Update AppHelper exports
-   - Publish new AppHelper version
-
-### Phase 2: Person Management Migration
-1. **Move person components to ChumsApp**
-   - Copy `PersonAdd` and `CreatePerson` to ChumsApp
-   - Update imports in ChumsApp files
-
-2. **Test and validate**
-   - Ensure person management workflows still work
-   - Verify no regression in membership features
-
-3. **Clean up AppHelper**
-   - Remove person components
-   - Update exports
-   - Publish updated version
-
-### Phase 3: Validation and Cleanup
-1. **Verify other projects**
-   - Ensure B1App, LessonsApp, etc. still work with new AppHelper
-   - Update any accidentally broken imports
-
-2. **Documentation update**
-   - Update component usage documentation
-   - Create migration guide for teams
-
----
-
-## Benefits Summary
-
-### For AppHelper
-- **Smaller bundle size**: Removes ~29% of components
-- **Cleaner scope**: Focuses on truly shared church management components
-- **Fewer dependencies**: Removes Stripe and CHUMS-specific integrations
-- **Better maintainability**: Less complex codebase
-
-### For ChumsApp
-- **Faster iteration**: Can modify donation and person management without affecting other apps
-- **Direct control**: Full ownership of CHUMS-specific business logic
-- **Customization freedom**: Can add CHUMS-specific features without AppHelper constraints
-
-### For Other Projects
-- **Smaller downloads**: Don't download unused donation code
-- **Fewer dependencies**: Less bloat from CHUMS-specific functionality
-- **Cleaner imports**: Only import actually relevant components
-
----
-
-## Risk Assessment
-
-### Low Risk
-- Person management extraction (small, self-contained)
-- Well-tested existing functionality
-
-### Medium Risk  
-- Donation system extraction (large codebase move)
-- Multiple component dependencies
-- Stripe integration complexity
-
-### Mitigation Strategies
-- **Gradual migration**: Move components in phases
-- **Thorough testing**: Test all donation workflows after migration
-- **Rollback plan**: Keep original components until migration is fully validated
-- **Documentation**: Clear migration guide for future reference
-
----
-
-## Conclusion
-
-The donation management system represents the largest opportunity for extraction, removing a significant amount of CHUMS-specific code from AppHelper while providing clear architectural benefits. The person management components are smaller but equally CHUMS-specific and should also be extracted.
-
-The messaging and reporting systems, while currently only used by CHUMS, represent generic church management functionality that other applications will likely need and should remain in AppHelper.
-
-**Recommended Action**: Proceed with extraction of donation system and person management components, prioritizing the donation system due to its size and impact.

package/CLAUDE.md

@@ -1,111 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-AppHelper is a React/Next.js component library for ChurchApps - a collection of Material-UI based components, helpers, and utilities for church management applications. It's published as `@churchapps/helpers` on npm and depends on `@churchapps/helpers` for core interfaces and utilities.
-
-## Build Commands
-
-```bash
-npm run clean          # Remove dist folder
-npm run tsc           # TypeScript compilation only
-npm run build         # Full build (clean + tsc + copy assets)
-npm run copy-assets   # Copy CSS, icons, emojis, and language files
-```
-
-### Asset Copying
-The build process copies several asset types to the dist folder:
-- CSS files from markdown editor
-- SVG icons (toolbar buttons, formatting icons)
-- Emoji images (PNG files)
-- Localization files (12 languages: en, de, es, fr, hi, it, ko, no, pt, ru, tl, zh)
-
-## Local Development & Linking
-
-Due to React peer dependency conflicts, linking requires special handling:
-
-```bash
-# In AppHelper directory:
-npm unlink ../../path/to/consumer/node_modules/react
-npm unlink ../../path/to/consumer/node_modules/react-dom  
-npm unlink ../../path/to/consumer/node_modules/react-router-dom
-npm run build
-npm link
-
-# In consumer project:
-npm link @churchapps/apphelper
-npm start
-```
-
-Alternative approach using npm pack:
-```bash
-npm run build && npm pack
-# Then reference the .tgz file in consumer's package.json
-```
-
-## Publishing
-
-```bash
-# Update version in package.json first
-npm run build
-npm publish --access=public
-```
-
-## Code Architecture
-
-### Core Structure
-- `src/components/` - React components using Material-UI 5
-- `src/helpers/` - Re-exports from @churchapps/helpers plus app-specific utilities
-- `src/donationComponents/` - Stripe-integrated donation forms and management
-- `src/pageComponents/` - Authentication pages (login, register, etc.)
-- `src/hooks/` - Custom React hooks
-
-### Key Components
-
-**SiteWrapper** - Main application shell with:
-- Material-UI navigation drawer
-- User authentication context
-- Notification system integration
-- Dynamic theming support
-
-**MarkdownEditor** - Lexical-based rich text editor with:
-- Lazy loading for performance
-- Toolbar with formatting options
-- Custom link and emoji plugins
-- Markdown transformers
-
-**Donation Components** - Stripe integration for:
-- One-time and recurring donations
-- Payment method management
-- Fund-specific donation handling
-
-### Helper Architecture
-- Extends `@churchapps/helpers` with app-specific utilities
-- `ApiHelper` - Centralized API communication with JWT authentication
-- `AppearanceHelper` - Theme and branding management
-- `SocketHelper` - Real-time communication
-- `CurrencyHelper`, `DateHelper` - Formatting utilities
-
-## Technology Stack
-
-- **React 18+** with TypeScript
-- **Material-UI 5** for components and theming
-- **Lexical** for rich text editing
-- **Stripe** for payment processing
-- **i18next** for internationalization (12 languages)
-- **Emotion** for CSS-in-JS styling
-
-## Code Style
-
-Key style rules enforced in the codebase:
-- 2-space indentation
-- Prefer double quotes for JSX
-- No trailing spaces
-- Arrow functions preferred
-- No trailing commas
-- Keep arrays/objects on single line when possible
-- Consistent array/object formatting
-
-Note: ESLint has been removed to eliminate deprecated dependency warnings. Code style is maintained manually.

package/COMPONENT_USAGE_REPORT.md

@@ -1,322 +0,0 @@
-# @churchapps/apphelper Component Usage Report
-
-Generated on: 2025-07-04
-
-## Executive Summary
-
-This report analyzes the usage of @churchapps/apphelper components across active projects in the LCS ecosystem. The package exports 34 React components, 14 helper utilities, and numerous TypeScript interfaces.
-
-**Note**: As of this report, donation management components (15 components) and person management components (2 components) have been moved from AppHelper to ChumsApp for better architectural separation.
-
-### Projects Using @churchapps/apphelper
-
-| Project | Version | Location | Primary Use Case |
-|---------|---------|----------|------------------|
-| **B1App** | 0.4.1 | `/mnt/e/LCS/B1/B1App/` | Main B1 platform application |
-| **ChumsApp** | 0.4.7 | `/mnt/e/LCS/Chums/ChumsApp/` | Church management system |
-| **ChumsTransfer** | 0.4.7 | `/mnt/e/LCS/Chums/ChumsTransfer/` | Church data transfer tool |
-| **LessonsApp** | ^0.3.46 | `/mnt/e/LCS/Lessons/LessonsApp/` | Lessons management |
-| **ChurchAppsWeb** | 0.0.5 | `/mnt/e/LCS/ChurchApps/ChurchAppsWeb/` | ChurchApps web platform |
-
-## Component Usage Matrix
-
-**Legend**: 
-- ✅ = Used from @churchapps/apphelper
-- 🏠 = Moved to local project (no longer in AppHelper)
-- ❌ = Not used
-
-### Core UI Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **DisplayBox** | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **Loading** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **SmallButton** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **InputBox** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **ErrorMessages** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **Banner** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **ExportLink** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **HelpIcon** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **TabPanel** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-### Authentication Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **LoginPage** | ✅ | ✅ | ✅ | ✅ | ✅ |
-| **LogoutPage** | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **Register** | ❌ | ❌ | ❌ | ✅ | ✅ |
-
-### Form & Input Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **CreatePerson** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **PersonAdd** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **FormSubmissionEdit** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **QuestionEdit** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ImageEditor** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **IconPicker** | ✅ | ❌ | ❌ | ❌ | ❌ |
-
-### Rich Text Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **MarkdownEditor** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **MarkdownPreview** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **MarkdownPreviewLight** | ✅ | ❌ | ❌ | ✅ | ❌ |
-
-### Communication Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **Conversations** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Conversation** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **Notes** | ❌ | ✅ | ❌ | ❌ | ❌ |
-| **Note** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **AddNote** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **NewPrivateMessage** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **PrivateMessageDetails** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **NewConversation** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-### Donation Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **DonationPage** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **DonationForm** | ✅ | 🏠 | ❌ | ❌ | ❌ |
-| **NonAuthDonation** | ✅ | 🏠 | ❌ | ❌ | ❌ |
-| **NonAuthDonationInner** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **PaymentMethods** | ✅ | 🏠 | ❌ | ❌ | ❌ |
-| **RecurringDonations** | ✅ | 🏠 | ❌ | ❌ | ❌ |
-| **RecurringDonationsEdit** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **FundDonations** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **FundDonation** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **BankForm** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **CardForm** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **FormCardPayment** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-| **DonationPreviewModal** | ❌ | 🏠 | ❌ | ❌ | ❌ |
-
-### Gallery & Media Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **GalleryModal** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **StockPhotos** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **B1ShareModal** | ✅ | ❌ | ❌ | ✅ | ❌ |
-
-### Support Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **FloatingSupport** | ❌ | ❌ | ❌ | ✅ | ✅ |
-| **SupportModal** | ❌ | ❌ | ❌ | ✅ | ❌ |
-| **SupportDrawer** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-### Reporting Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **ReportWithFilter** | ❌ | ✅ | ❌ | ❌ | ❌ |
-| **ReportFilter** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ReportFilterField** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ReportOutput** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ChartReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **TableReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **TreeReport** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-### Header & Navigation Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **SiteHeader** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **PrimaryMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SecondaryMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SecondaryMenuAlt** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **NavItem** | ❌ | ❌ | ❌ | ✅ | ❌ |
-
-### Wrapper Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **SiteWrapper** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **AppList** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ChurchList** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **UserMenu** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **Drawers** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **Notifications** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **PrivateMessages** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **TabPanel** (wrapper) | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-### Page Components
-
-| Component | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|-----------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **Forgot** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **Login** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **LoginSetPassword** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SelectChurchModal** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SelectChurchRegister** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SelectChurchSearch** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **SelectableChurch** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-## Helper Utilities Usage
-
-| Helper | B1App | ChumsApp | ChumsTransfer | LessonsApp | ChurchAppsWeb |
-|--------|:-----:|:--------:|:-------------:|:----------:|:-------------:|
-| **ApiHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
-| **UserHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
-| **ArrayHelper** | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **DateHelper** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **PersonHelper** | ✅ | ✅ | ✅ | ❌ | ❌ |
-| **CurrencyHelper** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **AppearanceHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **AnalyticsHelper** | ✅ | ✅ | ❌ | ✅ | ✅ |
-| **ErrorHelper** | ✅ | ✅ | ❌ | ✅ | ❌ |
-| **CommonEnvironmentHelper** | ✅ | ✅ | ✅ | ✅ | ✅ |
-| **UniqueIdHelper** | ✅ | ✅ | ❌ | ❌ | ❌ |
-| **SlugHelper** | ✅ | ❌ | ❌ | ✅ | ❌ |
-| **EventHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **SocketHelper** | ✅ | ❌ | ❌ | ❌ | ❌ |
-| **Locale** | ✅ | ✅ | ✅ | ✅ | ❌ |
-| **DonationHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **FileHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **ReportHelper** | ❌ | ❌ | ❌ | ❌ | ❌ |
-| **createEmotionCache** | ❌ | ❌ | ❌ | ❌ | ❌ |
-
-## Component Usage Analysis
-
-The following analysis shows component usage patterns, distinguishing between external project usage and internal AppHelper usage:
-
-### Components Used Internally by AppHelper (22 total)
-
-These components are not directly imported by external projects but are used internally by other AppHelper components:
-
-#### Core UI Components (4)
-- **HelpIcon** - Used by `DisplayBox` and `InputBox` components
-- **TabPanel** - Used by `UserMenu` and `GalleryModal` components
-- **QuestionEdit** - Used by `FormSubmissionEdit` component
-- **FormCardPayment** - Used by `QuestionEdit` component
-
-#### Notes & Communication Components (4)
-- **Note** - Used by `Notes` component
-- **AddNote** - Used by `Notes` and `NewPrivateMessage` components
-- **Conversation** - Used by `Conversations` component
-- **NewConversation** - Used by `Conversations` component
-
-#### Moved Components (17)
-These components have been moved to ChumsApp and are no longer part of AppHelper:
-- **Donation Components (13)**: DonationPage, DonationForm, NonAuthDonation, NonAuthDonationInner, PaymentMethods, RecurringDonations, RecurringDonationsEdit, FundDonations, FundDonation, BankForm, CardForm, FormCardPayment, DonationPreviewModal
-- **Person Management (2)**: PersonAdd, CreatePerson
-
-#### Gallery Components (1)
-- **StockPhotos** - Used by `GalleryModal` component
-
-#### Header Components (4)
-- **SupportDrawer** - Used by `SiteHeader` component
-- **PrimaryMenu** - Used by `SiteHeader` component
-- **SecondaryMenu** - Used by `SiteHeader` component
-- **SecondaryMenuAlt** - Used by `SiteHeader` component
-
-#### Reporting Components (6)
-- **ReportFilter** - Used by `ReportWithFilter` component
-- **ReportFilterField** - Used by `ReportFilter` component
-- **ReportOutput** - Used by `ReportWithFilter` component
-- **ChartReport** - Used by `ReportOutput` component
-- **TableReport** - Used by `ReportOutput` component
-- **TreeReport** - Used by `ReportOutput` component
-
-#### Wrapper Components (5)
-- **UserMenu** - Used by `SiteHeader` and `SiteWrapper` components
-- **AppList** - Used by `UserMenu` component
-- **ChurchList** - Used by `UserMenu` component
-- **Notifications** - Used by `UserMenu` component
-- **PrivateMessages** - Used by `UserMenu` component
-- **Drawers** - Used by `SiteWrapper` component
-
-#### Page Components (8)
-- **Forgot** - Used by `LoginPage` component
-- **Login** - Used by `LoginPage` component
-- **LoginSetPassword** - Used by `LoginPage` component
-- **SelectChurchModal** - Used by `LoginPage` component
-- **SelectChurchRegister** - Used by `SelectChurchSearch` component
-- **SelectChurchSearch** - Used by `SelectChurchSearch` component
-- **SelectableChurch** - Used by `SelectChurchSearch` component
-
-### Truly Unused Components (1 total)
-
-Only one component appears to have no usage either externally or internally:
-- **SiteWrapper** - Main site wrapper component (not used by any external projects or internal components)
-
-### Moved Components Summary (17 total)
-
-The following components have been extracted from AppHelper and moved to ChumsApp for better architectural separation:
-
-#### Donation Management System (13 components)
-- **Main Components**: DonationPage, DonationForm, NonAuthDonation
-- **Payment Processing**: PaymentMethods, BankForm, CardForm, FormCardPayment
-- **Fund Management**: FundDonations, FundDonation
-- **Recurring Donations**: RecurringDonations, RecurringDonationsEdit
-- **Internal Components**: NonAuthDonationInner, DonationPreviewModal
-
-#### Person Management (2 components)
-- **PersonAdd** - Add person to groups/systems
-- **CreatePerson** - Create new person records
-
-These components are now maintained within ChumsApp, allowing for faster iteration on CHUMS-specific functionality while reducing AppHelper's bundle size and complexity.
-
-### Unused Helper Utilities (4 total)
-1. **DonationHelper** - Donation-related utilities
-2. **FileHelper** - File handling utilities
-3. **ReportHelper** - Reporting utilities
-4. **createEmotionCache** - Emotion cache creation
-
-## Key Insights
-
-1. **Core Components**: The most widely used components are `DisplayBox`, `Loading`, `SmallButton`, `InputBox`, and `ErrorMessages`, which appear in most active projects.
-
-2. **Authentication**: All projects use `LoginPage`, making it the most universally adopted component. `LogoutPage` is used by all except ChurchAppsWeb.
-
-3. **Project-Specific Usage**:
-   - **B1App**: Uses the widest variety of components including donations, communications, and rich media
-   - **ChumsApp**: Focuses on forms, reporting, and person management
-   - **LessonsApp**: Uses support components uniquely among all projects
-   - **ChumsTransfer & ChurchAppsWeb**: Minimal usage, primarily authentication
-
-4. **Component Architecture**: AppHelper demonstrates excellent internal component composition with 22 components (65%) used internally by other components, showing a well-structured component hierarchy where complex components are built from simpler, focused components.
-
-5. **External vs Internal Usage**: Only 11 out of 34 components (32%) are directly imported by external projects, while 22 components (65%) serve as internal building blocks. Only 1 component (3%) appears to be truly unused.
-
-6. **Successful Component Extraction**: 17 components (50% of the original 51) have been successfully moved from AppHelper to ChumsApp, including the entire donation management system and person management components. This extraction significantly reduced AppHelper's bundle size and improved architectural separation.
-
-7. **Helper Utilities**: `ApiHelper` and `UserHelper` are universally used across all projects, while specialized helpers like `DonationHelper` and `FileHelper` remain unused.
-
-## Recommendations
-
-1. **✅ COMPLETED: Component Extraction**: Successfully moved 17 CHUMS-specific components to ChumsApp, including:
-   - Complete donation management system (13 components)  
-   - Person management components (2 components)
-   - Achieved 50% reduction in AppHelper component count (51 → 34)
-   - Eliminated Stripe dependencies from AppHelper
-   - Improved architectural separation
-
-2. **Maintain Component Architecture**: The current component composition strategy is excellent, with most components serving as internal building blocks. This architecture should be preserved as it promotes reusability and maintainability.
-
-3. **Documentation Enhancement**: 
-   - Document the internal component hierarchy to help developers understand the composition patterns
-   - Create examples for the 11 externally-used components to promote adoption
-   - Add architecture diagrams showing component dependencies
-   - Document the successful component extraction process for future reference
-
-4. **Minimal Cleanup**: Only `SiteWrapper` appears to be truly unused and could be considered for deprecation if confirmed to have no purpose.
-
-5. **Helper Utilities Review**: The 4 unused helper utilities (`DonationHelper`, `FileHelper`, `ReportHelper`, `createEmotionCache`) could be evaluated for removal if they serve no purpose.
-
-6. **External Adoption**: Consider promoting usage of high-level components like:
-   - `SiteHeader` for consistent navigation
-   - `FloatingSupport` and `SupportModal` for user assistance
-   - Rich text components (`MarkdownEditor`, `MarkdownPreview`) for content management
-
-7. **Component Export Strategy**: With the reduced component count (34 vs original 51), the public API surface is now more manageable. Consider whether all remaining components need to be exported, or if some internal-only components could be kept private.
-
-8. **Monitor ChumsApp Integration**: Validate that the moved components work correctly in ChumsApp and that the donation/person management workflows function as expected.

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2023 Live Church Solutions
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,24 +0,0 @@
-# AppHelper
-
-Helper functions shared by React and NextJS Apps
-
-## To Test
-
-1. In the AppHelper folder run `npm unlink ../../Chums/ChumsApp/node_modules/react ../../Chums/ChumsApp/node_modules/react-dom ../../Chums/ChumsApp/node_modules/react-router-dom` plugging, in the path to the app you plan to test with.
-2. Run `npm build` AppHelper folder
-3. Run `npm unlink ../../Chums/ChumsApp/node_modules/react ../../Chums/ChumsApp/node_modules/react-dom ../../Chums/ChumsApp/node_modules/react-router-dom`
-4. Run `npm link`
-5. Switch to the test project folder and run `npm link @churchapps/apphelper` to point to your local copy
-6. Run `npm start` or `npm run dev` within your test project
-
-### Alternatively
-
-1. Run `npm build` and `npm pack` in AppHelper folder
-2. In your project folder point to the .tgz file like so `"@churchapps/apphelper": "file:../../packages/AppHelper/churchapps-apphelper-0.0.24.tgz"`. Your path may be different.
-3. Run `npm i` on your test project.
-
-## To Publish
-
-1. Update version number in package.json
-2. Run `npm run build`
-3. Run `npm publish --access=public`