front-end-dev-standards 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "front-end-dev-standards",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Company-wide Angular coding standards for Cursor AI and GitHub Copilot",
   "license": "UNLICENSED",
   "type": "module",

package/scripts/validate-package.js

@@ -9,6 +9,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const STANDARDS_DIR = path.join(PACKAGE_ROOT, 'standards');
 
 const REQUIRED_PATHS = [
   'package.json',
@@ -17,14 +18,18 @@ const REQUIRED_PATHS = [
   'config/default.json',
   'templates/company.mdc.template',
   'templates/copilot-instructions.md.template',
-  'standards/angular.md',
-  'standards/architecture.md',
-  'standards/coding-style.md',
-  'standards/testing.md',
 ];
 
 const missing = REQUIRED_PATHS.filter((rel) => !fs.existsSync(path.join(PACKAGE_ROOT, rel)));
 
+const standardsFiles = fs.existsSync(STANDARDS_DIR)
+  ? fs.readdirSync(STANDARDS_DIR).filter((file) => file.endsWith('.md') && fs.statSync(path.join(STANDARDS_DIR, file)).isFile())
+  : [];
+
+if (standardsFiles.length === 0) {
+  missing.push('standards/*.md (at least one standards file required)');
+}
+
 if (missing.length > 0) {
   console.error('[dev-standards] Publish validation failed. Missing files:');
   missing.forEach((file) => console.error(`  - ${file}`));
@@ -38,4 +43,4 @@ if (pkg.private === true) {
   process.exit(1);
 }
 
-console.log(`[dev-standards] Publish validation passed (v${pkg.version}).`);
+console.log(`[dev-standards] Publish validation passed (v${pkg.version}, ${standardsFiles.length} standards files).`);

package/standards//342/232/241 performance.md"

@@ -0,0 +1,138 @@
+# Performance Standards
+
+Version: 1.0
+Framework: Angular 20+
+Goal: Fast, Efficient, Scalable Frontend
+
+---
+
+# 1. Performance Principles
+
+1. Load Only What Is Needed
+2. Lazy Load Everything Possible
+3. Minimize Change Detection
+4. Reduce Bundle Size
+5. Optimize API Calls
+6. Avoid Redundant Rendering
+
+---
+
+# 2. Bundle Size Limits
+
+| Type           | Limit   |
+| -------------- | ------- |
+| Initial Bundle | < 500KB |
+| Feature Bundle | < 250KB |
+| Chunk Size     | < 150KB |
+
+---
+
+# 3. Lazy Loading Standards
+
+All features must be lazy loaded:
+
+```typescript
+loadComponent: () =>
+  import('./page').then(m => m.Page)
+```
+
+---
+
+# 4. Change Detection
+
+Mandatory:
+
+✓ OnPush everywhere
+✓ Signals for state
+
+Avoid default detection.
+
+---
+
+# 5. Rendering Optimization
+
+Use:
+
+✓ track in @for
+✓ virtual scrolling
+✓ memoized computed signals
+
+---
+
+# 6. Image Optimization
+
+Use:
+
+✓ NgOptimizedImage
+✓ Lazy loading images
+
+---
+
+# 7. API Optimization
+
+Rules:
+
+* Batch requests when possible
+* Avoid duplicate calls
+* Cache static data
+
+---
+
+# 8. Memory Management
+
+Avoid:
+
+❌ Memory leaks
+❌ Unsubscribed observables
+
+Use:
+
+✓ Async pipe
+✓ Signals
+
+---
+
+# 9. UI Performance Rules
+
+Avoid:
+
+❌ Heavy DOM manipulation
+❌ Large nested components
+
+Prefer:
+
+✓ Component splitting
+
+---
+
+# 10. Router Performance
+
+* Lazy load routes
+* Preload only critical modules
+
+---
+
+# 11. Core Web Vitals Targets
+
+| Metric | Target  |
+| ------ | ------- |
+| LCP    | < 2.5s  |
+| FID    | < 100ms |
+| CLS    | < 0.1   |
+
+---
+
+# 12. Profiling Standards
+
+Use:
+
+* Chrome DevTools
+* Angular DevTools
+
+---
+
+# 13. Anti Patterns
+
+❌ DOM queries
+❌ Inline heavy calculations
+❌ Large single components