create-content-sdk-app 2.0.2 → 2.1.0-canary.1

package/dist/templates/nextjs-app-router/.cursor/rules/general.mdc

@@ -1,80 +1,80 @@
----
-description: Core coding principles for your Sitecore project
-alwaysApply: true
-globs: []
----
-
-# General Coding Principles
-
-## Universal Standards
-
-DRY Principle:
-
-- Don't Repeat Yourself - extract common functionality
-- Create reusable utilities and helper functions
-- Use composition over inheritance
-- Share types and interfaces across modules
-
-SOLID Principles:
-
-- Single Responsibility: each function/class has one purpose
-- Open/Closed: extend functionality through composition
-- Dependency Inversion: depend on abstractions, not implementations
-
-Code Clarity:
-
-- Write self-documenting code with clear intent
-- Use meaningful names that express business concepts
-- Prefer explicit over implicit behavior
-- Make dependencies and requirements obvious
-
-## Architecture Patterns
-
-Modular Design:
-
-- Organize code into focused, cohesive modules
-- Minimize coupling between modules
-- Use clear interfaces between layers
-- Follow established patterns consistently
-
-Data Flow:
-
-- Prefer unidirectional data flow
-- Validate inputs at system boundaries
-- Transform data at appropriate layers
-- Handle errors close to their source
-
-Testing:
-
-- Write testable code with minimal dependencies
-- Use dependency injection for better testability
-- Mock external services and side effects
-- Test behavior, not implementation details
-
-## Development Standards
-
-Version Control:
-
-- Write descriptive commit messages
-- Keep commits focused and atomic
-- Use branching strategies appropriate to team size
-- Review code before merging
-
-Documentation:
-
-- Document public APIs and interfaces
-- Include usage examples for complex functionality
-- Keep documentation close to code
-- Update documentation with code changes
-
-Performance:
-
-- Optimize for readability first, performance second
-- Profile before optimizing
-- Cache expensive operations appropriately
-- Consider memory usage and cleanup
-
-Referenced:
-@src/app/
-@src/components/
-@src/lib/
+---
+description: Core coding principles for your Sitecore project
+alwaysApply: true
+globs: []
+---
+
+# General Coding Principles
+
+## Universal Standards
+
+DRY Principle:
+
+- Don't Repeat Yourself - extract common functionality
+- Create reusable utilities and helper functions
+- Use composition over inheritance
+- Share types and interfaces across modules
+
+SOLID Principles:
+
+- Single Responsibility: each function/class has one purpose
+- Open/Closed: extend functionality through composition
+- Dependency Inversion: depend on abstractions, not implementations
+
+Code Clarity:
+
+- Write self-documenting code with clear intent
+- Use meaningful names that express business concepts
+- Prefer explicit over implicit behavior
+- Make dependencies and requirements obvious
+
+## Architecture Patterns
+
+Modular Design:
+
+- Organize code into focused, cohesive modules
+- Minimize coupling between modules
+- Use clear interfaces between layers
+- Follow established patterns consistently
+
+Data Flow:
+
+- Prefer unidirectional data flow
+- Validate inputs at system boundaries
+- Transform data at appropriate layers
+- Handle errors close to their source
+
+Testing:
+
+- Write testable code with minimal dependencies
+- Use dependency injection for better testability
+- Mock external services and side effects
+- Test behavior, not implementation details
+
+## Development Standards
+
+Version Control:
+
+- Write descriptive commit messages
+- Keep commits focused and atomic
+- Use branching strategies appropriate to team size
+- Review code before merging
+
+Documentation:
+
+- Document public APIs and interfaces
+- Include usage examples for complex functionality
+- Keep documentation close to code
+- Update documentation with code changes
+
+Performance:
+
+- Optimize for readability first, performance second
+- Profile before optimizing
+- Cache expensive operations appropriately
+- Consider memory usage and cleanup
+
+Referenced:
+@src/app/
+@src/components/
+@src/lib/

package/dist/templates/nextjs-app-router/.cursor/rules/javascript.mdc

@@ -1,112 +1,112 @@
----
-description: JavaScript/TypeScript rules for your Sitecore App Router project
-alwaysApply: false
-globs:
-  - '**/*.js'
-  - '**/*.ts'
-  - '**/*.tsx'
-  - '**/*.mjs'
----
-
-# JavaScript/TypeScript Rules
-
-## Naming Conventions
-
-Variables and Functions:
-
-- Use camelCase: `getUserData()`, `isLoading`, `currentUser`
-- Boolean variables: prefix with `is`, `has`, `can`, `should`
-- Event handlers: prefix with `handle` or `on`: `handleClick`, `onSubmit`
-
-Components (React):
-
-- Use PascalCase: `SitecoreComponent`, `PageLayout`, `ContentBlock`
-- File names match component names: `SitecoreComponent.tsx`
-
-Constants:
-
-- Use UPPER_SNAKE_CASE: `API_ENDPOINT`, `DEFAULT_TIMEOUT`, `MAX_RETRIES`
-- Export at module level when shared
-
-Directories:
-
-- Use kebab-case: `src/components`, `src/api-clients`, `src/sitecore-utils`
-- Organize by feature when appropriate: `src/content-management/`
-
-Types and Interfaces:
-
-- Use PascalCase with descriptive names: `ContentItem`, `LayoutProps`, `SitecoreConfig`
-- Prefix interfaces with `I` only when needed for disambiguation
-
-## Code Layout and Organization
-
-Directory Structure:
-
-```
-src/
-  app/                 # App Router pages and layouts
-  components/          # UI components (React)
-  lib/                 # Configuration and utilities
-  i18n/                # Internationalization setup
-  types/               # TypeScript type definitions
-```
-
-File Organization:
-
-- Server Components for data fetching and static content
-- Client Components for interactivity (use 'use client')
-- Group related functionality in feature directories
-- Keep components co-located with their styles and tests
-
-## Error Handling
-
-API Calls:
-
-- Always wrap in try/catch blocks
-- Throw custom errors with context: `SitecoreFetchError`, `ConfigurationError`
-- Handle edge cases with guard clauses
-
-```typescript
-async function fetchContent(id: string): Promise<ContentItem> {
-  if (!id) {
-    throw new Error('Content ID is required');
-  }
-
-  try {
-    const response = await sitecoreClient.getItem(id);
-    return response.data;
-  } catch (error) {
-    throw new SitecoreFetchError(`Failed to fetch content ${id}`, error);
-  }
-}
-```
-
-## Security
-
-Input Validation:
-
-- Sanitize user inputs before processing
-- Validate data at application boundaries
-- Use type guards for runtime type checking
-- Escape content when rendering to prevent XSS
-
-## Performance
-
-Optimization Patterns:
-
-- Cache API responses using React Query or SWR
-- Use Server Components for better performance
-- Lazy-load non-critical modules: `const Component = lazy(() => import('./Component'))`
-- Use useCallback and useMemo for expensive operations in Client Components
-
-TypeScript:
-
-- Enable strict mode in tsconfig.json
-- Prefer type assertions over any: `value as ContentItem`
-- Use discriminated unions for complex state management
-
-Referenced:
-@src/app/
-@src/components/
-@src/lib/
-
+---
+description: JavaScript/TypeScript rules for your Sitecore App Router project
+alwaysApply: false
+globs:
+  - '**/*.js'
+  - '**/*.ts'
+  - '**/*.tsx'
+  - '**/*.mjs'
+---
+
+# JavaScript/TypeScript Rules
+
+## Naming Conventions
+
+Variables and Functions:
+
+- Use camelCase: `getUserData()`, `isLoading`, `currentUser`
+- Boolean variables: prefix with `is`, `has`, `can`, `should`
+- Event handlers: prefix with `handle` or `on`: `handleClick`, `onSubmit`
+
+Components (React):
+
+- Use PascalCase: `SitecoreComponent`, `PageLayout`, `ContentBlock`
+- File names match component names: `SitecoreComponent.tsx`
+
+Constants:
+
+- Use UPPER_SNAKE_CASE: `API_ENDPOINT`, `DEFAULT_TIMEOUT`, `MAX_RETRIES`
+- Export at module level when shared
+
+Directories:
+
+- Use kebab-case: `src/components`, `src/api-clients`, `src/sitecore-utils`
+- Organize by feature when appropriate: `src/content-management/`
+
+Types and Interfaces:
+
+- Use PascalCase with descriptive names: `ContentItem`, `LayoutProps`, `SitecoreConfig`
+- Prefix interfaces with `I` only when needed for disambiguation
+
+## Code Layout and Organization
+
+Directory Structure:
+
+```
+src/
+  app/                 # App Router pages and layouts
+  components/          # UI components (React)
+  lib/                 # Configuration and utilities
+  i18n/                # Internationalization setup
+  types/               # TypeScript type definitions
+```
+
+File Organization:
+
+- Server Components for data fetching and static content
+- Client Components for interactivity (use 'use client')
+- Group related functionality in feature directories
+- Keep components co-located with their styles and tests
+
+## Error Handling
+
+API Calls:
+
+- Always wrap in try/catch blocks
+- Throw custom errors with context: `SitecoreFetchError`, `ConfigurationError`
+- Handle edge cases with guard clauses
+
+```typescript
+async function fetchContent(id: string): Promise<ContentItem> {
+  if (!id) {
+    throw new Error('Content ID is required');
+  }
+
+  try {
+    const response = await sitecoreClient.getItem(id);
+    return response.data;
+  } catch (error) {
+    throw new SitecoreFetchError(`Failed to fetch content ${id}`, error);
+  }
+}
+```
+
+## Security
+
+Input Validation:
+
+- Sanitize user inputs before processing
+- Validate data at application boundaries
+- Use type guards for runtime type checking
+- Escape content when rendering to prevent XSS
+
+## Performance
+
+Optimization Patterns:
+
+- Cache API responses using React Query or SWR
+- Use Server Components for better performance
+- Lazy-load non-critical modules: `const Component = lazy(() => import('./Component'))`
+- Use useCallback and useMemo for expensive operations in Client Components
+
+TypeScript:
+
+- Enable strict mode in tsconfig.json
+- Prefer type assertions over any: `value as ContentItem`
+- Use discriminated unions for complex state management
+
+Referenced:
+@src/app/
+@src/components/
+@src/lib/
+