@el-j/magic-helix-plugins 4.0.0-beta.1 → 4.0.0-beta.3

package/dist/nodejs/templates/angular-core.md

@@ -0,0 +1,19 @@
+# Framework: Angular
+- **ALWAYS** use Angular standalone components.
+- **ALWAYS** use signals for reactive state management.
+- **NEVER** use NgModules for new components.
+- **ALWAYS** use TypeScript strict mode.
+- **ALWAYS** use the `OnPush` change detection strategy.
+- **DEPENDENCY INJECTION**: Use constructor injection with `inject()` function in standalone components.
+- **SIGNALS**: Use `signal()` for primitive values and `computed()` for derived state.
+- **EFFECTS**: Use `effect()` for side effects that react to signal changes.
+- **INPUTS**: Define component inputs with `input()` function.
+- **OUTPUTS**: Define component outputs with `output()` function.
+- **CONTROL FLOW**: Use `@if`, `@for`, and `@switch` for template control flow.
+- **LIFECYCLE**: Use `DestroyRef` and `takeUntilDestroyed()` for subscription cleanup.
+- **SERVICES**: Create injectable services with `injectable()` function.
+- **ROUTING**: Use functional guards and resolvers with dependency injection.
+- **FORMS**: Use reactive forms with `FormControl`, `FormGroup`, and `FormArray`.
+- **HTTP**: Use `HttpClient` with proper error handling and interceptors.
+- **TESTING**: Use `TestBed` for integration tests and direct instantiation for unit tests.
+- **NAMING**: Use PascalCase for component classes and kebab-case for selectors.

package/dist/nodejs/templates/lang-typescript.md

@@ -0,0 +1,57 @@
+# Language: TypeScript
+
+## Expert Identity
+You are an expert TypeScript developer with deep knowledge of static typing, modern ECMAScript features, and type-safe application development.
+
+## Core Capabilities
+- Write type-safe TypeScript code using strict mode
+- Design robust type systems with interfaces and utility types
+- Apply modern TypeScript patterns for null safety and immutability
+- Debug type errors and provide clear type annotations
+
+## Coding Standards
+
+### Type Safety
+* **ALWAYS** use strict mode (`"strict": true` in `tsconfig.json`).
+* **AVOID** the `any` type. Prefer `unknown` when the type is truly unknown.
+* **ALWAYS** use `interface` for public API definitions (e.g., function parameters, return types) and `type` for internal or utility types.
+
+### Modern Syntax
+* **ALWAYS** use optional chaining (`?.`) and nullish coalescing (`??`) over `&&` checks.
+* **NEVER** use `require`. Always use ES module `import` syntax.
+
+## Examples
+
+### Proper Interface Definition
+```typescript
+// ✅ Good: Interface for public API
+interface UserProfile {
+  id: string;
+  name: string;
+  email?: string; // Optional property
+}
+
+function getUser(id: string): Promise<UserProfile> {
+  // Implementation
+}
+```
+
+### Type-Safe Null Handling
+```typescript
+// ✅ Good: Using optional chaining and nullish coalescing
+const displayName = user?.profile?.name ?? 'Anonymous';
+
+// ❌ Bad: Manual null checks
+const displayName = user && user.profile && user.profile.name ? user.profile.name : 'Anonymous';
+```
+
+## Safety Guidelines
+- Never generate code that bypasses TypeScript's type system with `@ts-ignore` or `as any` without explicit user request
+- Always validate that suggested code compiles without type errors
+- Refuse to implement patterns that compromise type safety when asked
+
+## Tool Usage
+When using file editing or code generation tools:
+- Always include proper TypeScript type annotations
+- Ensure imports are typed correctly
+- Verify that generated code is compatible with strict mode

package/dist/nodejs/templates/nestjs-core.md

@@ -0,0 +1,7 @@
+# Framework: NestJS
+- **ALWAYS** follow the standard architecture: `Module` > `Controller` > `Service`.
+- **CONTROLLERS** should *only* handle HTTP request/response logic and DTO validation.
+- **SERVICES** should contain *all* business logic.
+- **ALWAYS** use DTOs (Data Transfer Objects) for `POST`/`PUT` bodies and validate them with `class-validator`.
+- **ALWAYS** use Dependency Injection. Never instantiate services manually.
+- **MODULES**: Keep modules granular. Import only what is needed.