@el-j/magic-helix-plugins 4.0.0-beta.6 → 4.0.0-beta.8

package/dist/{BasePlugin-6wv0hYJ9.js → BasePlugin-BXz3Zpy5.js}

@@ -1,21 +1,22 @@
-import * as s from "node:fs";
-import * as a from "node:path";
-class l {
+import * as n from "node:fs";
+import * as s from "node:path";
+import { fileURLToPath as c } from "node:url";
+class u {
   // Helper methods for common operations
   /**
    * Check if a file exists in the project
    */
   fileExists(e, r) {
-    return s.existsSync(a.join(e, r));
+    return n.existsSync(s.join(e, r));
   }
   /**
    * Read a file from the project
    */
   readFile(e, r) {
     try {
-      const t = a.join(e, r);
-      if (s.existsSync(t))
-        return s.readFileSync(t, "utf-8");
+      const t = s.join(e, r);
+      if (n.existsSync(t))
+        return n.readFileSync(t, "utf-8");
     } catch {
     }
     return null;
@@ -36,15 +37,31 @@ class l {
    * Get project name from path
    */
   getProjectName(e) {
-    return a.basename(e);
+    return s.basename(e);
+  }
+  /**
+   * List entries in a project directory (non-recursive)
+   */
+  listFiles(e) {
+    try {
+      return n.readdirSync(e);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Get the directory name from import.meta.url (ES module alternative to __dirname)
+   */
+  getDirname(e) {
+    return s.dirname(c(e));
   }
   /**
    * Load template from file
    */
   async loadTemplateFromFile(e) {
     try {
-      if (s.existsSync(e))
-        return s.readFileSync(e, "utf-8");
+      if (n.existsSync(e))
+        return n.readFileSync(e, "utf-8");
     } catch {
     }
     return null;
@@ -52,12 +69,12 @@ class l {
   /**
    * Create a template definition with lazy loading
    */
-  createTemplate(e, r, t, n = {}) {
+  createTemplate(e, r, t, i = {}) {
     return {
       name: e,
       tags: r,
       content: t,
-      ...n
+      ...i
     };
   }
   /**
@@ -65,9 +82,9 @@ class l {
    */
   parseDependencies(e, ...r) {
     const t = {};
-    for (const n of r) {
-      const i = e[n];
-      i && typeof i == "object" && Object.assign(t, i);
+    for (const i of r) {
+      const a = e[i];
+      a && typeof a == "object" && Object.assign(t, a);
     }
     return t;
   }
@@ -93,5 +110,5 @@ class l {
   }
 }
 export {
-  l as B
+  u as B
 };

package/dist/BasePlugin-Be6rLq9o.cjs

@@ -0,0 +1 @@
+"use strict";var o=Object.create;var l=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var y=Object.getPrototypeOf,p=Object.prototype.hasOwnProperty;var g=(n,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of d(e))!p.call(n,s)&&s!==t&&l(n,s,{get:()=>e[s],enumerable:!(r=f(e,s))||r.enumerable});return n};var m=(n,e,t)=>(t=n!=null?o(y(n)):{},g(e||!n||!n.__esModule?l(t,"default",{value:n,enumerable:!0}):t,n));const b=require("node:fs"),h=require("node:path"),F=require("node:url");function u(n){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const t in n)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(n,t);Object.defineProperty(e,t,r.get?r:{enumerable:!0,get:()=>n[t]})}}return e.default=n,Object.freeze(e)}const i=u(b),a=u(h);class S{fileExists(e,t){return i.existsSync(a.join(e,t))}readFile(e,t){try{const r=a.join(e,t);if(i.existsSync(r))return i.readFileSync(r,"utf-8")}catch{}return null}readJSON(e,t){try{const r=this.readFile(e,t);if(r)return JSON.parse(r)}catch{}return null}getProjectName(e){return a.basename(e)}listFiles(e){try{return i.readdirSync(e)}catch{return[]}}getDirname(e){return a.dirname(F.fileURLToPath(e))}async loadTemplateFromFile(e){try{if(i.existsSync(e))return i.readFileSync(e,"utf-8")}catch{}return null}createTemplate(e,t,r,s={}){return{name:e,tags:t,content:r,...s}}parseDependencies(e,...t){const r={};for(const s of t){const c=e[s];c&&typeof c=="object"&&Object.assign(r,c)}return r}async findFiles(e,t){try{const{glob:r}=await import("glob");return await r(t,{cwd:e,absolute:!1})}catch{return[]}}async hasFiles(e,t){return(await this.findFiles(e,t)).length>0}}exports.BasePlugin=S;

package/dist/cpp/index.cjs

@@ -1,5 +1,5 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("../BasePlugin-odQJAKA-.cjs");class m extends u.BasePlugin{constructor(){super(...arguments),this.name="cpp",this.displayName="C/C++",this.version="3.0.0",this.priority=85}async detect(t){const i=[],s={};let r,o=this.getProjectName(t);const e=await this.detectPlatformIO(t);if(e&&(i.push("platformio"),r="platformio.ini",e.board&&i.push(`board-${e.board}`),e.platform&&(i.push(`platform-${e.platform}`),e.platform.includes("espressif32")&&i.push("esp32"),e.platform.includes("espressif8266")&&i.push("esp8266"),e.platform.includes("atmelavr")&&i.push("arduino")),e.framework&&(i.push(`framework-${e.framework}`),e.framework==="arduino"&&i.push("arduino")),e.libs))for(const a of e.libs)s[a]="*";if(this.fileExists(t,"CMakeLists.txt")){i.push("cmake"),r||(r="CMakeLists.txt");const a=this.readFile(t,"CMakeLists.txt");if(a){const c=a.match(/project\s*\(\s*([^\s)]+)/i);c&&(o=c[1])}}return(this.fileExists(t,"Makefile")||this.fileExists(t,"makefile"))&&(i.push("makefile"),r||(r="Makefile")),await this.hasFiles(t,"*.ino")&&(i.push("arduino"),r||(r="*.ino")),await this.hasFiles(t,"**/*.{cpp,c,h,hpp}")&&(i.push("cpp"),r||(r="*.cpp")),i.length===0?null:{language:"C/C++",name:o,dependencies:s,manifestFile:r,projectPath:t,tags:i}}async detectPlatformIO(t){if(!this.fileExists(t,"platformio.ini"))return null;const i=this.readFile(t,"platformio.ini");if(!i)return null;const s={libs:[]},r=i.split(`
-`);let o=!1,e=null;for(const p of r){const n=p.trim();if(n.startsWith("[env:")){o=!0,e=null;continue}if(n.startsWith("[")&&n.endsWith("]")){o=!1,e=null;continue}if(o||!s.board){const l=n.match(/^(\w+)\s*=\s*(.*)$/);if(l){const[,f,a]=l;switch(e=f,f){case"board":s.board=a.trim();break;case"platform":s.platform=a.trim();break;case"framework":s.framework=a.trim();break;case"lib_deps":a.trim()&&s.libs?.push(a.trim());break}}else e==="lib_deps"&&n&&!n.startsWith("[")&&s.libs?.push(n)}}return s.board||s.platform?s:null}getTemplates(){return[{name:"cpp-core",tags:["cpp"],content:this.getCppTemplate()},{name:"platformio-core",tags:["platformio"],content:this.getPlatformIOTemplate()},{name:"arduino-core",tags:["arduino"],content:this.getArduinoTemplate()}]}getDependencyTagMap(){return{boost:"boost",fmt:"fmt",spdlog:"spdlog",googletest:"gtest",catch2:"catch2","Adafruit GFX Library":"adafruit-gfx",WiFi:"wifi",ESP32:"esp32",FastLED:"fastled",ArduinoJson:"arduino-json"}}getConfigFileTagMap(){return{"platformio.ini":"platformio","CMakeLists.txt":"cmake",Makefile:"makefile",".clang-format":"clang-format",".clang-tidy":"clang-tidy"}}getCppTemplate(){return`# C/C++ Development Guidelines
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../BasePlugin-Be6rLq9o.cjs");var p=typeof document<"u"?document.currentScript:null;class d extends m.BasePlugin{constructor(){super(...arguments),this.name="cpp",this.displayName="C/C++",this.version="3.0.0",this.priority=85}async detect(t){const i=[],r={};let s,o=this.getProjectName(t);const e=await this.detectPlatformIO(t);if(e&&(i.push("platformio"),s="platformio.ini",e.board&&i.push(`board-${e.board}`),e.platform&&(i.push(`platform-${e.platform}`),e.platform.includes("espressif32")&&i.push("esp32"),e.platform.includes("espressif8266")&&i.push("esp8266"),e.platform.includes("atmelavr")&&i.push("arduino")),e.framework&&(i.push(`framework-${e.framework}`),e.framework==="arduino"&&i.push("arduino")),e.libs))for(const n of e.libs)r[n]="*";if(this.fileExists(t,"CMakeLists.txt")){i.push("cmake"),s||(s="CMakeLists.txt");const n=this.readFile(t,"CMakeLists.txt");if(n){const u=n.match(/project\s*\(\s*([^\s)]+)/i);u&&(o=u[1])}}return(this.fileExists(t,"Makefile")||this.fileExists(t,"makefile"))&&(i.push("makefile"),s||(s="Makefile")),await this.hasFiles(t,"*.ino")&&(i.push("arduino"),s||(s="*.ino")),await this.hasFiles(t,"**/*.{cpp,c,h,hpp}")&&(i.push("cpp"),s||(s="*.cpp")),i.length===0?null:{language:"C/C++",name:o,dependencies:r,manifestFile:s,projectPath:t,tags:i}}async detectPlatformIO(t){if(!this.fileExists(t,"platformio.ini"))return null;const i=this.readFile(t,"platformio.ini");if(!i)return null;const r={libs:[]},s=i.split(`
+`);let o=!1,e=null;for(const f of s){const a=f.trim();if(a.startsWith("[env:")){o=!0,e=null;continue}if(a.startsWith("[")&&a.endsWith("]")){o=!1,e=null;continue}if(o||!r.board){const l=a.match(/^(\w+)\s*=\s*(.*)$/);if(l){const[,c,n]=l;switch(e=c,c){case"board":r.board=n.trim();break;case"platform":r.platform=n.trim();break;case"framework":r.framework=n.trim();break;case"lib_deps":n.trim()&&r.libs?.push(n.trim());break}}else e==="lib_deps"&&a&&!a.startsWith("[")&&r.libs?.push(a)}}return r.board||r.platform?r:null}getTemplates(){return this.getDirname(typeof document>"u"?require("url").pathToFileURL(__filename).href:p&&p.tagName.toUpperCase()==="SCRIPT"&&p.src||new URL("cpp/index.cjs",document.baseURI).href),[{name:"cpp-core",tags:["cpp"],content:this.getCppTemplate()},{name:"platformio-core",tags:["platformio"],content:this.getPlatformIOTemplate()},{name:"arduino-core",tags:["arduino"],content:this.getArduinoTemplate()}]}getDependencyTagMap(){return{boost:"boost",fmt:"fmt",spdlog:"spdlog",googletest:"gtest",catch2:"catch2","Adafruit GFX Library":"adafruit-gfx",WiFi:"wifi",ESP32:"esp32",FastLED:"fastled",ArduinoJson:"arduino-json"}}getConfigFileTagMap(){return{"platformio.ini":"platformio","CMakeLists.txt":"cmake",Makefile:"makefile",".clang-format":"clang-format",".clang-tidy":"clang-tidy"}}getCppTemplate(){return`# C/C++ Development Guidelines
 
 This project uses C/C++.
 
@@ -76,4 +76,4 @@ This is an Arduino project.
 - Check Serial Monitor baud rate
 - Validate sensor readings
 - Test incrementally
-`}}exports.CppPlugin=m;
+`}}exports.CppPlugin=d;

package/dist/cpp/index.mjs

@@ -1,4 +1,4 @@
-import { B as u } from "../BasePlugin-6wv0hYJ9.js";
+import { B as u } from "../BasePlugin-BXz3Zpy5.js";
 class g extends u {
   constructor() {
     super(...arguments), this.name = "cpp", this.displayName = "C/C++", this.version = "3.0.0", this.priority = 85;
@@ -74,7 +74,7 @@ class g extends u {
     return s.board || s.platform ? s : null;
   }
   getTemplates() {
-    return [
+    return this.getDirname(import.meta.url), [
       {
         name: "cpp-core",
         tags: ["cpp"],

package/dist/csharp/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("node:path"),p=require("../BasePlugin-odQJAKA-.cjs");function l(n){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const t in n)if(t!=="default"){const a=Object.getOwnPropertyDescriptor(n,t);Object.defineProperty(e,t,a.get?a:{enumerable:!0,get:()=>n[t]})}}return e.default=n,Object.freeze(e)}const u=l(c);class g extends p.BasePlugin{constructor(){super(...arguments),this.name="csharp",this.displayName="C#",this.version="3.0.0",this.priority=60}async detect(e){const t=await this.findFiles(e,"*.csproj");if(t.length===0)return null;const a=t[0],s=this.readFile(e,a),r={};if(s){const o=s.matchAll(/<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g);for(const i of o)r[i[1]]=i[2]||"*"}return{language:"C#",name:a.replace(".csproj",""),dependencies:r,manifestFile:a,projectPath:e}}getTemplates(){return[{name:"csharp-core",tags:["csharp","dotnet"],content:()=>this.loadTemplateFromFile(u.join(__dirname,"templates/lang-csharp.md")).then(e=>e||this.getCSharpFallbackTemplate())}]}getCSharpFallbackTemplate(){return`# C# / .NET Development Guidelines
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("node:path"),l=require("../BasePlugin-Be6rLq9o.cjs");var a=typeof document<"u"?document.currentScript:null;function u(n){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const t in n)if(t!=="default"){const r=Object.getOwnPropertyDescriptor(n,t);Object.defineProperty(e,t,r.get?r:{enumerable:!0,get:()=>n[t]})}}return e.default=n,Object.freeze(e)}const d=u(p);class g extends l.BasePlugin{constructor(){super(...arguments),this.name="csharp",this.displayName="C#",this.version="3.0.0",this.priority=60}async detect(e){const t=await this.findFiles(e,"*.csproj");if(t.length===0)return null;const r=t[0],s=this.readFile(e,r),i={};if(s){const o=s.matchAll(/<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g);for(const c of o)i[c[1]]=c[2]||"*"}return{language:"C#",name:r.replace(".csproj",""),dependencies:i,manifestFile:r,projectPath:e}}getTemplates(){const e=this.getDirname(typeof document>"u"?require("url").pathToFileURL(__filename).href:a&&a.tagName.toUpperCase()==="SCRIPT"&&a.src||new URL("csharp/index.cjs",document.baseURI).href);return[{name:"csharp-core",tags:["csharp","dotnet"],content:()=>this.loadTemplateFromFile(d.join(e,"templates/lang-csharp.md")).then(t=>t||this.getCSharpFallbackTemplate())}]}getCSharpFallbackTemplate(){return`# C# / .NET Development Guidelines
 
 This project uses C# and .NET.
 

package/dist/csharp/index.mjs

@@ -1,14 +1,14 @@
 import * as o from "node:path";
-import { B as p } from "../BasePlugin-6wv0hYJ9.js";
-class g extends p {
+import { B as p } from "../BasePlugin-BXz3Zpy5.js";
+class m extends p {
   constructor() {
     super(...arguments), this.name = "csharp", this.displayName = "C#", this.version = "3.0.0", this.priority = 60;
   }
   async detect(e) {
-    const s = await this.findFiles(e, "*.csproj");
-    if (s.length === 0)
+    const t = await this.findFiles(e, "*.csproj");
+    if (t.length === 0)
       return null;
-    const t = s[0], n = this.readFile(e, t), a = {};
+    const s = t[0], n = this.readFile(e, s), a = {};
     if (n) {
       const i = n.matchAll(
         /<PackageReference\s+Include="([^"]+)"(?:\s+Version="([^"]+)")?/g
@@ -18,20 +18,21 @@ class g extends p {
     }
     return {
       language: "C#",
-      name: t.replace(".csproj", ""),
+      name: s.replace(".csproj", ""),
       dependencies: a,
-      manifestFile: t,
+      manifestFile: s,
       projectPath: e
     };
   }
   getTemplates() {
+    const e = this.getDirname(import.meta.url);
     return [
       {
         name: "csharp-core",
         tags: ["csharp", "dotnet"],
         content: () => this.loadTemplateFromFile(
-          o.join(__dirname, "templates/lang-csharp.md")
-        ).then((e) => e || this.getCSharpFallbackTemplate())
+          o.join(e, "templates/lang-csharp.md")
+        ).then((t) => t || this.getCSharpFallbackTemplate())
       }
     ];
   }
@@ -64,5 +65,5 @@ This project uses C# and .NET.
   }
 }
 export {
-  g as CSharpPlugin
+  m as CSharpPlugin
 };

package/dist/dart/templates/flutter.md

@@ -0,0 +1,340 @@
+# Flutter Development Guidelines
+
+## Architecture & Structure
+
+### Project Organization
+```
+lib/
+├── main.dart
+├── app.dart
+├── core/
+│   ├── constants/
+│   ├── theme/
+│   └── utils/
+├── features/
+│   ├── auth/
+│   │   ├── data/
+│   │   ├── domain/
+│   │   └── presentation/
+│   └── home/
+└── shared/
+    ├── widgets/
+    └── models/
+```
+
+## Widget Best Practices
+
+### StatelessWidget
+```dart
+class UserCard extends StatelessWidget {
+  const UserCard({
+    super.key,
+    required this.user,
+    this.onTap,
+  });
+
+  final User user;
+  final VoidCallback? onTap;
+
+  @override
+  Widget build(BuildContext context) {
+    return Card(
+      child: ListTile(
+        title: Text(user.name),
+        subtitle: Text(user.email),
+        onTap: onTap,
+      ),
+    );
+  }
+}
+```
+
+### StatefulWidget
+```dart
+class Counter extends StatefulWidget {
+  const Counter({super.key});
+
+  @override
+  State<Counter> createState() => _CounterState();
+}
+
+class _CounterState extends State<Counter> {
+  int _count = 0;
+
+  @override
+  void dispose() {
+    // Clean up resources
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Text('Count: $_count'),
+        ElevatedButton(
+          onPressed: () => setState(() => _count++),
+          child: const Text('Increment'),
+        ),
+      ],
+    );
+  }
+}
+```
+
+## State Management
+
+### Riverpod (Recommended)
+```dart
+final userProvider = StateNotifierProvider<UserNotifier, AsyncValue<User>>((ref) {
+  return UserNotifier();
+});
+
+class UserNotifier extends StateNotifier<AsyncValue<User>> {
+  UserNotifier() : super(const AsyncValue.loading());
+
+  Future<void> fetchUser(String id) async {
+    state = const AsyncValue.loading();
+    state = await AsyncValue.guard(() => api.getUser(id));
+  }
+}
+
+// Usage in widget
+class UserProfile extends ConsumerWidget {
+  @override
+  Widget build(BuildContext context, WidgetRef ref) {
+    final userState = ref.watch(userProvider);
+    
+    return userState.when(
+      data: (user) => Text(user.name),
+      loading: () => CircularProgressIndicator(),
+      error: (err, stack) => Text('Error: $err'),
+    );
+  }
+}
+```
+
+### Bloc Pattern
+```dart
+class UserBloc extends Bloc<UserEvent, UserState> {
+  UserBloc() : super(UserInitial()) {
+    on<LoadUser>(_onLoadUser);
+  }
+
+  Future<void> _onLoadUser(LoadUser event, Emitter<UserState> emit) async {
+    emit(UserLoading());
+    try {
+      final user = await repository.getUser(event.id);
+      emit(UserLoaded(user));
+    } catch (e) {
+      emit(UserError(e.toString()));
+    }
+  }
+}
+```
+
+## Navigation
+
+### Named Routes
+```dart
+// Define routes
+final routes = {
+  '/': (context) => HomeScreen(),
+  '/profile': (context) => ProfileScreen(),
+  '/settings': (context) => SettingsScreen(),
+};
+
+// Navigate
+Navigator.pushNamed(context, '/profile');
+
+// With arguments
+Navigator.pushNamed(
+  context,
+  '/profile',
+  arguments: {'userId': '123'},
+);
+```
+
+### Go Router (Modern)
+```dart
+final router = GoRouter(
+  routes: [
+    GoRoute(
+      path: '/',
+      builder: (context, state) => HomeScreen(),
+    ),
+    GoRoute(
+      path: '/profile/:id',
+      builder: (context, state) {
+        final id = state.pathParameters['id']!;
+        return ProfileScreen(userId: id);
+      },
+    ),
+  ],
+);
+
+// Navigate
+context.go('/profile/123');
+context.push('/settings');
+```
+
+## Performance Optimization
+
+### const Constructors
+```dart
+// Use const wherever possible
+const Text('Hello');
+const Padding(padding: EdgeInsets.all(8.0));
+const SizedBox(height: 16);
+```
+
+### ListView.builder
+```dart
+// For large lists, use builder
+ListView.builder(
+  itemCount: items.length,
+  itemBuilder: (context, index) {
+    return ListTile(title: Text(items[index]));
+  },
+);
+```
+
+### Keys
+```dart
+// Use keys for widgets that need to preserve state
+ListView(
+  children: items.map((item) => 
+    ListTile(
+      key: ValueKey(item.id),
+      title: Text(item.name),
+    )
+  ).toList(),
+);
+```
+
+## Responsive Design
+
+### MediaQuery
+```dart
+final size = MediaQuery.of(context).size;
+final isPortrait = size.height > size.width;
+
+if (size.width > 600) {
+  // Tablet layout
+} else {
+  // Mobile layout
+}
+```
+
+### LayoutBuilder
+```dart
+LayoutBuilder(
+  builder: (context, constraints) {
+    if (constraints.maxWidth > 600) {
+      return WideLayout();
+    }
+    return NarrowLayout();
+  },
+);
+```
+
+## Testing
+
+### Widget Tests
+```dart
+testWidgets('Counter increments', (tester) async {
+  await tester.pumpWidget(
+    MaterialApp(home: Counter()),
+  );
+
+  expect(find.text('0'), findsOneWidget);
+  
+  await tester.tap(find.byType(ElevatedButton));
+  await tester.pump();
+  
+  expect(find.text('1'), findsOneWidget);
+});
+```
+
+### Integration Tests
+```dart
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('Complete user flow', (tester) async {
+    await tester.pumpWidget(MyApp());
+    
+    // Login
+    await tester.enterText(find.byKey(Key('email')), 'test@test.com');
+    await tester.tap(find.byKey(Key('login')));
+    await tester.pumpAndSettle();
+    
+    // Verify home screen
+    expect(find.text('Welcome'), findsOneWidget);
+  });
+}
+```
+
+## Best Practices
+
+### Widget Composition
+- Break large widgets into smaller, reusable components
+- Extract complex logic into separate methods or classes
+- Use const constructors to improve performance
+
+### Error Handling
+- Use ErrorWidget.builder for custom error widgets
+- Wrap risky operations in try-catch
+- Provide meaningful error messages to users
+
+### Asset Management
+```yaml
+# pubspec.yaml
+flutter:
+  assets:
+    - assets/images/
+    - assets/icons/
+  fonts:
+    - family: Roboto
+      fonts:
+        - asset: fonts/Roboto-Regular.ttf
+```
+
+### Platform-Specific Code
+```dart
+import 'dart:io' show Platform;
+
+if (Platform.isAndroid) {
+  // Android-specific
+} else if (Platform.isIOS) {
+  // iOS-specific
+}
+```
+
+## Common Patterns
+
+### Dependency Injection
+```dart
+class MyApp extends StatelessWidget {
+  final ApiService apiService;
+  final AuthService authService;
+
+  const MyApp({
+    required this.apiService,
+    required this.authService,
+  });
+}
+```
+
+### Service Locator
+```dart
+final getIt = GetIt.instance;
+
+void setupLocator() {
+  getIt.registerSingleton<ApiService>(ApiService());
+  getIt.registerLazySingleton<AuthService>(() => AuthService());
+}
+
+// Usage
+final api = getIt<ApiService>();
+```