@el-j/magic-helix-core 4.0.0-beta.2 → 4.0.0-beta.4

package/dist/default_templates/swift/lang-swift.md

@@ -1,291 +0,0 @@
-# Swift Language Instructions
-
-## Project Type
-- Language: Swift
-- Package Manager: Swift Package Manager (SPM)
-- Platform: {iOS|macOS|Linux|Server}
-
-## Build Commands
-
-### Swift Package Manager
-```bash
-swift build              # Build project
-swift test               # Run tests
-swift run                # Run executable
-swift package update     # Update dependencies
-swift package clean      # Clean build artifacts
-```
-
-### Xcode
-```bash
-xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15'
-xcodebuild test -scheme MyApp
-```
-
-## Code Conventions
-
-### Swift Basics
-```swift
-// Variables and constants
-var mutableValue = 42
-let constantValue = 100
-
-// Optionals
-var name: String? = "John"
-if let unwrappedName = name {
-    print(unwrappedName)
-}
-
-// Nil coalescing
-let displayName = name ?? "Anonymous"
-
-// Optional chaining
-let length = user?.name?.count
-```
-
-### Structs and Classes
-```swift
-struct User {
-    let id: UUID
-    var name: String
-    var email: String
-    
-    func fullProfile() -> String {
-        "\(name) <\(email)>"
-    }
-}
-
-class UserRepository {
-    private var users: [User] = []
-    
-    func add(_ user: User) {
-        users.append(user)
-    }
-    
-    func find(by id: UUID) -> User? {
-        users.first { $0.id == id }
-    }
-}
-```
-
-### Protocols and Extensions
-```swift
-protocol Identifiable {
-    var id: UUID { get }
-}
-
-extension User: Identifiable {}
-
-extension String {
-    func toSnakeCase() -> String {
-        // Implementation
-    }
-}
-```
-
-### Async/Await (Concurrency)
-```swift
-func fetchUser(id: UUID) async throws -> User {
-    let (data, _) = try await URLSession.shared.data(from: url)
-    return try JSONDecoder().decode(User.self, from: data)
-}
-
-// Usage
-Task {
-    do {
-        let user = try await fetchUser(id: userId)
-        print(user.name)
-    } catch {
-        print("Error: \(error)")
-    }
-}
-```
-
-### Error Handling
-```swift
-enum UserError: Error {
-    case notFound
-    case invalidEmail
-}
-
-func getUser(id: UUID) throws -> User {
-    guard let user = findUser(id) else {
-        throw UserError.notFound
-    }
-    return user
-}
-
-// Usage
-do {
-    let user = try getUser(id: userId)
-} catch UserError.notFound {
-    print("User not found")
-} catch {
-    print("Unknown error: \(error)")
-}
-```
-
-## Testing with XCTest
-
-```swift
-import XCTest
-@testable import MyApp
-
-final class UserTests: XCTestCase {
-    func testUserFullProfile() {
-        let user = User(
-            id: UUID(),
-            name: "John",
-            email: "john@example.com"
-        )
-        
-        XCTAssertEqual(user.fullProfile(), "John <john@example.com>")
-    }
-    
-    func testAsyncFunction() async throws {
-        let user = try await fetchUser(id: testUserId)
-        XCTAssertEqual(user.name, "John")
-    }
-}
-```
-
-## Docker for Server-Side Swift
-
-### Multi-stage Dockerfile
-```dockerfile
-# Build stage
-FROM swift:5.9-jammy AS build
-WORKDIR /app
-
-COPY Package.swift Package.resolved ./
-RUN swift package resolve
-
-COPY . .
-RUN swift build -c release --static-swift-stdlib
-
-# Runtime stage
-FROM ubuntu:22.04
-WORKDIR /app
-
-RUN apt-get update && apt-get install -y \
-    libcurl4 \
-    libxml2 \
-    && rm -rf /var/lib/apt/lists/*
-
-COPY --from=build /app/.build/release/MyApp ./
-
-RUN useradd -m -u 1000 swift
-USER swift
-
-EXPOSE 8080
-CMD ["./MyApp"]
-```
-
-### Docker Compose
-```yaml
-services:
-  app:
-    build: .
-    ports:
-      - "8080:8080"
-    environment:
-      - DATABASE_URL=postgresql://postgres:password@db/myapp
-    depends_on:
-      - db
-  
-  db:
-    image: postgres:15-alpine
-    environment:
-      POSTGRES_PASSWORD: password
-```
-
-## Package.swift Structure
-
-```swift
-// swift-tools-version: 5.9
-import PackageDescription
-
-let package = Package(
-    name: "MyApp",
-    platforms: [
-        .macOS(.v13),
-        .iOS(.v16),
-        .linux
-    ],
-    products: [
-        .executable(name: "MyApp", targets: ["MyApp"]),
-        .library(name: "MyLibrary", targets: ["MyLibrary"])
-    ],
-    dependencies: [
-        .package(url: "https://github.com/vapor/vapor.git", from: "4.89.0")
-    ],
-    targets: [
-        .executableTarget(
-            name: "MyApp",
-            dependencies: [
-                .product(name: "Vapor", package: "vapor")
-            ]
-        ),
-        .testTarget(
-            name: "MyAppTests",
-            dependencies: ["MyApp"]
-        )
-    ]
-)
-```
-
-## Memory Management
-
-```swift
-// ARC (Automatic Reference Counting)
-class User {
-    var name: String
-    init(name: String) { self.name = name }
-}
-
-// Weak references to avoid retain cycles
-class ViewController {
-    weak var delegate: UserDelegate?
-}
-
-// Unowned for guaranteed non-nil references
-class Order {
-    unowned let customer: Customer
-}
-```
-
-## Performance Tips
-
-- Use value types (structs) for immutable data
-- Leverage copy-on-write for collections
-- Use `lazy` for expensive computations
-- Profile with Instruments
-- Use `@inlinable` for small, frequently-called functions
-- Prefer `async/await` over completion handlers
-- Use actors for thread-safe state
-
-## Common Frameworks
-
-### iOS/macOS
-- **SwiftUI**: Modern declarative UI
-- **Combine**: Reactive programming
-- **CoreData**: Persistence
-- **URLSession**: Networking
-
-### Server-Side
-- **Vapor**: Web framework
-- **Fluent**: ORM
-- **PostgresNIO**: PostgreSQL driver
-- **AsyncHTTPClient**: HTTP client
-
-## Best Practices
-
-- Use optionals appropriately
-- Prefer value types over reference types
-- Use guard statements for early returns
-- Implement proper error handling
-- Write unit tests
-- Use protocols for abstraction
-- Follow Swift naming conventions
-- Use type inference wisely
-- Leverage Swift's type safety

package/dist/default_templates/vue/style-primevue.md

@@ -1,6 +0,0 @@
-# UI Library: PrimeVue
-- **ALWAYS** use PrimeVue components for UI elements (Button, InputText, DataTable).
-- **STYLING**: Use PrimeVue's "pass-through" (PT) properties to apply Tailwind classes for customization.
-- **NEVER** override PrimeVue styles with global CSS.
-- **ICONS**: Use the icon library configured with PrimeVue (e.g., PrimeIcons or MDI).
-- **FORMS**: Use `vee-validate` in combination with PrimeVue form components.

package/dist/default_templates/vue/style-quasar.md

@@ -1,22 +0,0 @@
-# Styling: Quasar (Vue)
-- **ALWAYS** use Quasar v2+ with Vue 3 Composition API.
-- **ALWAYS** use `q-` prefixed classes for Quasar components.
-- **ALWAYS** use `QLayout`, `QHeader`, `QDrawer`, `QPage` for app structure.
-- **ALWAYS** use `QBtn` with appropriate color and size props.
-- **ALWAYS** use `QInput` and `QSelect` for form inputs.
-- **ALWAYS** use `QCard`, `QCardSection` for content containers.
-- **ALWAYS** use `QTable` for data tables with proper column definitions.
-- **ALWAYS** use `QDialog` for modals with `v-model` binding.
-- **ALWAYS** use `QMenu` for context menus and dropdowns.
-- **ALWAYS** use `QChip` for tags and status indicators.
-- **ALWAYS** use `QAvatar` for user profile displays.
-- **ALWAYS** use `QList` and `QItem` for navigation and lists.
-- **ALWAYS** use `QStepper` for multi-step processes.
-- **ALWAYS** use `QTabs` and `QTab` for tabbed interfaces.
-- **ALWAYS** use `QExpansionItem` for collapsible content.
-- **ALWAYS** use `QSpinner` for loading states.
-- **ALWAYS** use `QNotify` for toast notifications.
-- **ALWAYS** use `QLoading` for full-screen loading overlays.
-- **ALWAYS** use `Dark` plugin for dark mode support.
-- **ALWAYS** use `Quasar.lang` for internationalization.
-- **ALWAYS** use `Quasar.iconSet` for custom icon sets.

package/dist/default_templates/vue/vue-core.md

@@ -1,108 +0,0 @@
-# Framework: Vue 3
-
-## Expert Identity
-You are an expert Vue 3 developer specializing in the Composition API, TypeScript integration, and scalable component architecture.
-
-## Core Capabilities
-- Build reactive Vue 3 applications using Composition API
-- Design type-safe components with TypeScript
-- Create reusable composables following best practices
-- Implement clean separation between logic and presentation
-- Debug Vue applications using Vue DevTools
-
-## Coding Standards
-
-### Component Structure
-- **ALWAYS** use Vue 3 with the Composition API.
-- **NEVER** use the Options API.
-- **ALWAYS** use `<script setup lang="ts">`.
-- **WHEN POSSIBLE** use `<script setup lang="ts" generic="T">` with generic type interfaces.
-- **ALWAYS** use TypeScript.
-
-### Component Design
-- **ALWAYS** Use single-file components (`.vue` files) but keep them logic-free
-- **ALWAYS** Use composables to create the vue reactivity "bridge" using logic from utils.
-- **ALWAYS** Use utility functions for **all** logic, without vue-dependency
-- **ALWAYS** Use templates only for rendering, avoid logic in templates.
-
-### Composable Organization
-- **ALWAYS** create composable folders with the `composableName` and inside:
-  - `index.ts` for main composable export
-  - `types/` folder for types/interfaces with single files for each type and index.ts exporting them
-  - `utils/` for helper functions with single files for each util and index.ts exporting them
-  - `__tests__/` folder for unit tests with single test files for each unit test and index.ts exporting them
-
-### Reactivity
-- **PREFER** `defineModel` where `defineProps` with `defineEmits` update is needed.
-- **ALWAYS** define Props and emits with `defineProps` and `defineEmits`
-- **ALWAYS** Use `ref()` for primitive values and `reactive()` for objects.
-- **ALWAYS** Use `computed` for derived state.
-- **ALWAYS** Use `watch` or `watchEffect` for side effects, but **AVOID** overusing them.
-
-### Ecosystem
-- **ALWAYS** Use Vue Router for routing.
-- **AVOID** Use Pinia for state management. use singleton store imlpementations with composables instead.
-- **ALWAYS** Use Vitest for unit tests of all utils and composables.
-- **ALWAYS** Use Vue's built-in directives (`v-if`, `v-for`, `v-show`, etc.) for conditional rendering and list rendering.
-- **ALWAYS** Use slots for component composition.
-
-## Examples
-
-### Composable Structure
-```typescript
-// composables/useCounter/index.ts
-import { ref, computed } from 'vue';
-import type { CounterState } from './types';
-import { increment, decrement } from './utils';
-
-export function useCounter(initialValue = 0) {
-  const count = ref<number>(initialValue);
-  const doubled = computed(() => count.value * 2);
-  
-  return {
-    count,
-    doubled,
-    increment: () => count.value = increment(count.value),
-    decrement: () => count.value = decrement(count.value),
-  };
-}
-```
-
-### Component with Script Setup
-```vue
-<script setup lang="ts">
-import { useCounter } from '@/composables/useCounter';
-
-interface Props {
-  initialCount?: number;
-}
-
-const props = withDefaults(defineProps<Props>(), {
-  initialCount: 0,
-});
-
-const { count, doubled, increment, decrement } = useCounter(props.initialCount);
-</script>
-
-<template>
-  <div>
-    <p>Count: {{ count }}</p>
-    <p>Doubled: {{ doubled }}</p>
-    <button @click="increment">+</button>
-    <button @click="decrement">-</button>
-  </div>
-</template>
-```
-
-## Tool Usage
-When creating or editing Vue files:
-- Use the `create_file` or `replace_string_in_file` tools
-- Always generate complete `.vue` files with proper `<script setup>`, `<template>`, and optional `<style>` blocks
-- Ensure TypeScript types are defined in separate `types/` files when complex
-
-## Safety Guidelines
-- Never generate code that mixes Options API and Composition API
-- Refuse to create components without TypeScript when the project uses TypeScript
-- Always validate that reactive references are properly unwrapped in templates
-- Follow Vue's official style guide for naming and structure
-- Use Vue DevTools for debugging and performance monitoring

package/dist/default_templates/vue/vue-pinia.md

@@ -1,5 +0,0 @@
-# State: Pinia
-- **ALWAYS** use Pinia for global state management.
-- Define stores in the `src/stores` directory (e.g., `useUserStore.ts`).
-- **ALWAYS** use the `setup` store syntax (function-based) instead of the `options` store syntax.
-- **NEVER** access `localStorage` directly from a component. Encapsulate this logic within the Pinia store itself.