@pattern-stack/frontend-patterns 0.1.3 → 0.2.0-alpha.0

package/CHANGELOG.md

@@ -5,81 +5,76 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.2] - 2025-08-09
+## [Unreleased]
 
 ### Fixed
-- CLI module format issue - removed `"type": "module"` from package.json to fix CommonJS/ESM conflict
-- CSS export paths - added multiple export paths for easier importing
-- TypeScript type exports - exported missing interface types (CardProps, SpinnerProps, LabelProps, SelectProps)
-- CLI help command - improved help text with examples and version info
+- **TypeScript Build Errors**: Resolved all TypeScript compilation errors across codegen and auth modules
+  - Added missing type imports in OpenAPI codegen (`ParsedParameter`, `ClientGeneratorOptions`)
+  - Fixed OpenAPIV3 namespace imports and type casting
+  - Corrected parser method signatures and response array handling
+  - Updated `isListEndpoint` to correctly access responses as array
+- **Auth Type System**: Consolidated user types for better type safety
+  - Moved `name`, `roles`, and `permissions` to `BaseUser` as optional fields
+  - Made `ExtendedUser` a type alias to `BaseUser` for backward compatibility
+  - Updated `MockAuthService` and `MockAuthProvider` to use consolidated types
+  - Added proper `RegisterData` interface
+- **Test Suite**: Fixed all test failures
+  - Updated hook generator tests to use correct `ParsedEndpoint` response format (array instead of object)
+  - All 173 tests now passing
+- **Performance**: Improved MockAuthProvider performance
+  - Added memoization to prevent creating new auth service instance on every render
+- **Component Exports**: Standardized component export patterns
+  - Consolidated type exports using modern TypeScript syntax (`export { Component, type Props }`)
 
 ### Changed
-- Package is now properly marked as private on NPM (requires authentication)
-
-## [0.1.1] - 2025-08-09 (skipped)
-
-### Fixed
-- CLI module format issue - removed `"type": "module"` from package.json to fix CommonJS/ESM conflict
-- CSS export paths - added multiple export paths for easier importing
-- TypeScript type exports - exported missing interface types (CardProps, SpinnerProps, LabelProps, SelectProps)
-- CLI help command - improved help text with examples and version info
-
-### Changed
-- Package is now properly marked as private on NPM (requires authentication)
-
-## [0.1.0] - 2025-08-09
-
-### Added - Initial Release 🚀
-
-#### Core Features
-- Complete atomic architecture component library (atoms, molecules, organisms, templates)
-- Factory pattern for creating React applications with minimal boilerplate
-- Comprehensive design system with 8 semantic color palettes
-- Domain-driven UI system for automatic component selection
-
-#### Components
-- **UI Primitives**: Button, Card, Input, Select, Badge, Table, and more
-- **Data Components**: DataTable with smart rendering, StatCard, Chart, DataBadge
-- **Layout Components**: AppLayout, Sidebar, AppHeader with responsive design
-- **Templates**: AdminDashboard, DataTemplate, EntityManagement templates
-
-#### Hook Generation System
-- CLI tool for generating React hooks from OpenAPI specifications
-- Automatic detection of bulk operations
-- Full TypeScript type safety
-- TanStack Query integration
-
-#### Responsive Design
-- Progressive responsive system with custom breakpoints
-- Mobile-first approach with intelligent component adaptation
-- Dynamic view modes (table/card switching)
-
-#### Enhanced DataTemplate
-- Server-side operations (pagination, filtering, sorting)
-- Inline editing with validation and optimistic updates
-- Bulk operations UI (85% complete, awaiting API integration)
-- Progressive responsive design
-
-#### Developer Experience
-- Zero-config setup with sensible defaults
-- Automatic UI component selection based on data types
-- Built-in authentication patterns
-- Comprehensive TypeScript support
-
-### Infrastructure
-- Vite-based build system
-- ESLint rules for design system compliance
-- Local development testing setup
-- NPM package distribution ready
-
-### Documentation
-- Comprehensive README with examples
-- Atomic architecture guidelines
-- Hook generation guide
-- Design system documentation
-
----
-
-This is the foundation release of Pattern Stack Frontend Patterns - a reusable React template for building production-ready applications with minimal boilerplate. 
-
-Built with ❤️ for developers who want to focus on business logic, not infrastructure.
+- **SkeletonAvatar API**: Changed from `size` prop to separate `width` and `height` props
+  - **Breaking Change**: `<SkeletonAvatar size={40} />` is no longer supported
+  - **Migration**: Use `<SkeletonAvatar width={40} height={40} />` instead
+  - Added comprehensive JSDoc with migration examples
+- **DataTable Templates**: Removed unsupported props from DataTemplate usage
+  - Removed `onSort`, `selectedRows`, `onSelectionChange` props
+  - Added TODO comments for future server-side sorting support (FRO-4)
+
+### Removed
+- **Map Components**: Temporarily removed map component suite due to `react-map-gl` type compatibility issues
+  - Removed: `MapCluster`, `MapContainer`, `MapHeatmap`, `MapMarker`, `MapPolygon`, `MapPopup`, `MapRoute`
+  - Removed: `MapProvider` context system
+  - Removed: `DataMap` and `LocationPicker` composed components
+  - Removed: Map-related templates and demo pages
+  - **Note**: Components preserved in `backup/map-components` branch for future restoration
+  - **Impact**: Applications using map components will need to use alternative mapping solutions until type issues are resolved
+- **Entity Templates**: Removed incomplete entity template and organism components
+  - Removed: `EntityManagementTemplate`, `EntityPerformanceDashboardTemplate`
+  - Removed: `CategoryBreakdownPanel`, `EntityListPanel`, `MetricsOverviewPanel`, `TrendAnalysisPanel`
+  - **Reason**: Incomplete implementations with placeholder text and non-functional features
+  - **Note**: Will be properly implemented in example applications and promoted back to template when production-ready
+- **Metric Card Refactoring**: Removed incomplete metric card refactoring files
+  - Removed: `MetricCardRefactored.tsx`, `NewMetricCard.tsx`, `NewMetricCard.demo.tsx`, `NewMetricCard.meta.ts`, `NewMetricCard.presets.tsx`, `REFACTORING.md`
+  - Removed: 16 commented export placeholders in `variants/index.ts`
+  - **Reason**: Only 3 of 19 variants were refactored, leaving most functionality using fallback implementations
+  - **Note**: Original MetricCard remains fully functional
+- **Bulk Operations Code**: Removed commented placeholder code for future FRO-35 implementation
+  - Removed: ~150 lines of commented code from `hook-generator.ts`
+  - Removed: `APIConfig` interface, `detectResourceOperations()` method, `createDefaultConfig()` method
+  - **Reason**: Placeholder code should not ship in pre-release; will implement from scratch when FRO-35 begins
+  - **Impact**: No impact - code was non-functional and commented out
+- **Production Code Cleanup**: Removed debug and temporary code
+  - Removed: Console.log statements from `hook-generator.ts`
+  - Removed: Placeholder alert() handlers from `UserAvatar.tsx` (replaced with documented extension points)
+  - Removed: WIP/TODO comments from `Chart.tsx` (replaced with professional JSDoc)
+
+### Internal
+- **Build Status**: Clean TypeScript compilation with zero errors
+- **Test Coverage**: 173/173 tests passing across 17 test files
+- **Type Safety**: Improved type inference throughout auth and codegen modules
+- **Code Quality**:
+  - Better component organization and import consistency
+  - Removed ~600+ lines of incomplete, commented, or placeholder code
+  - No console statements in production code
+  - All components have professional documentation
+  - Clean pre-release state with no partial implementations
+
+## Version History
+
+### Pre-release Development
+This is a pre-release version of the React Frontend Template. Breaking changes may occur without prior notice until v1.0.0 release.

package/README.md

@@ -34,11 +34,26 @@ app.addRoutes("/reports", ReportsRoutes)
 
 ### Installation
 
+This is a private package published to npm. Install using standard npm commands:
+
 ```bash
-# Install from NPM
+# Install latest version
 npm install @pattern-stack/frontend-patterns
 
-# Or for local development/testing
+# Install specific version
+npm install @pattern-stack/frontend-patterns@0.2.0-alpha.0
+
+# Or add to package.json dependencies
+{
+  "dependencies": {
+    "@pattern-stack/frontend-patterns": "^0.2.0-alpha.0"
+  }
+}
+```
+
+**For Local Development:**
+```bash
+# Install from local filesystem
 npm install file:../path/to/frontend-patterns
 
 # Or link for active development

package/cli/commands/generate-hooks.ts

@@ -7,7 +7,7 @@
  */
 
 import { promises as fs } from 'fs'
-import { join, dirname, resolve } from 'path'
+import { join, dirname } from 'path'
 import { loadOpenAPISpec, parseOpenAPI } from '../../src/codegen/openapi/parser.js'
 import { generateTypes } from '../../src/codegen/openapi/type-generator.js'
 import { generateAPIClient } from '../../src/codegen/openapi/client-generator.js'
@@ -177,7 +177,7 @@ export { queryKeys } from './hooks'`
 async function ensureDir(dir: string) {
   try {
     await fs.mkdir(dir, { recursive: true })
-  } catch (error) {
+  } catch {
     // Directory might already exist
   }
 }

package/cli/commands/scaffold.ts

@@ -213,7 +213,7 @@ export type { ${name}TemplateProps } from './${name}Template'`
 async function ensureDir(dir: string) {
   try {
     await fs.mkdir(dir, { recursive: true })
-  } catch (error) {
+  } catch {
     // Directory might already exist
   }
 }

package/cli/index.ts

@@ -18,9 +18,7 @@ const program = new Command()
 program
   .name('pattern-stack')
   .description('Pattern-Stack CLI for code generation and scaffolding')
-  .version('0.1.1')
-  .helpOption('-h, --help', 'Display help for command')
-  .addHelpText('after', '\nExamples:\n  $ pattern-stack generate hooks ./openapi.json --output ./src/api\n  $ pattern-stack scaffold component UserCard\n  $ pattern-stack init financial --name my-app')
+  .version('1.0.0')
 
 // Generate commands
 const generateCommand = program

package/cli/src/codegen/openapi/client-generator.js

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * API Client Generator
  *
@@ -7,10 +6,8 @@
  *
  * Part of FRO-12: API Client Generator
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.APIClientGenerator = void 0;
-exports.generateAPIClient = generateAPIClient;
-class APIClientGenerator {
+export class APIClientGenerator {
+    options;
     constructor(options = {}) {
         this.options = {
             clientType: options.clientType || 'axios',
@@ -591,16 +588,7 @@ export * from './client'
 export * from './methods'
 export * from './types'
 export * from './config'
-export { createAPIClient, defaultConfig } from './config'
-
-// Singleton instance for convenient usage
-export const apiClient = createAPIClient({
-  baseUrl: process.env.VITE_API_URL || '${this.options.baseUrl || 'http://localhost:8080'}',
-  timeout: ${this.options.timeout},
-  defaultHeaders: {
-    'Content-Type': 'application/json'
-  }
-})`;
+export { createAPIClient, defaultConfig } from './config'`;
     }
     generateFileHeader(title) {
         return `/**
@@ -664,9 +652,8 @@ export const apiClient = createAPIClient({
         return str.charAt(0).toUpperCase() + str.slice(1);
     }
 }
-exports.APIClientGenerator = APIClientGenerator;
 // Factory function
-function generateAPIClient(parsedAPI, options) {
+export function generateAPIClient(parsedAPI, options) {
     const generator = new APIClientGenerator(options);
     return generator.generate(parsedAPI);
 }