@maccesar/titools 2.2.4 → 2.2.8

package/skills/ti-expert/references/error-handling.md

@@ -1,6 +1,6 @@
-# Error Handling & Logging Guide
+# Error handling & logging guide
 
-## AppError Classes
+## Apperror classes
 
 ```javascript
 // lib/core/appError.js
@@ -49,7 +49,7 @@ exports.ErrorCodes = {
 }
 ```
 
-## Logger Service
+## Logger service
 
 ```javascript
 // lib/services/logger.js
@@ -142,7 +142,7 @@ class Logger {
 module.exports = new Logger()
 ```
 
-## Error Handler Service
+## Error handler service
 
 ```javascript
 // lib/services/errorHandler.js
@@ -197,7 +197,7 @@ function _getUserMessage(error) {
 }
 ```
 
-## Using the Logger
+## Using the logger
 
 ```javascript
 // lib/services/userService.js
@@ -233,7 +233,7 @@ exports.getUserProfile = async function getUserProfile(userId) {
 }
 ```
 
-## API Client Error Handling
+## API client error handling
 
 ```javascript
 // lib/api/client.js
@@ -302,7 +302,7 @@ exports.get = async function get(endpoint, params = {}) {
 }
 ```
 
-## Controller Error Handling Pattern
+## Controller error handling pattern
 
 ```javascript
 // controllers/user/detail.js
@@ -376,7 +376,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Global Error Handler
+## Global error handler
 
 ```javascript
 // alloy.js - Setup global error catching
@@ -396,7 +396,7 @@ if (Ti.App.deployType === 'production') {
 }
 ```
 
-## Crash Reporting Integration
+## Crash reporting integration
 
 ```javascript
 // lib/services/crashReporting.js
@@ -425,7 +425,7 @@ exports.reportToCrashService = function reportToCrashService(error, context = {}
 }
 ```
 
-## Validation Helper
+## Validation helper
 
 ```javascript
 // lib/helpers/validator.js
@@ -465,7 +465,7 @@ exports.validateRequired = function validateRequired(value, fieldName) {
 }
 ```
 
-## Logging Best Practices
+## Logging best practices
 
 | Practice                   | Example                                                |
 | -------------------------- | ------------------------------------------------------ |

package/skills/ti-expert/references/examples.md

@@ -1,6 +1,6 @@
-# Alloy Implementation Examples
+# Alloy implementation examples
 
-## API Client Service
+## API client service
 Standard logic for network requests.
 
 ```javascript
@@ -18,7 +18,7 @@ exports.get = function(endpoint, params = {}) {
 }
 ```
 
-## Native Module Wrapper Service
+## Native module wrapper service
 Encapsulate native modules (e.g., audio, maps, facebook) to decouple from controllers.
 
 ```javascript
@@ -33,7 +33,7 @@ exports.performAction = function(data) {
 }
 ```
 
-## i18n Helper
+## i18n helper
 Logic for complex string transformations and plurals.
 
 ```javascript
@@ -44,7 +44,7 @@ exports.getPluralMessages = function(count) {
 }
 ```
 
-## Model with SQL Adapter
+## Model with SQL adapter
 Definition for local SQLite persistence.
 
 ```javascript
@@ -64,7 +64,7 @@ exports.definition = {
 }
 ```
 
-## Fully Styled & Accessible View
+## Fully styled & accessible view
 Applying TSS styles while maintaining accessibility.
 
 ```xml
@@ -111,7 +111,7 @@ Applying TSS styles while maintaining accessibility.
 - Use margins on children for spacing (NOT padding on parent)
 - Use `Ti.UI.FILL` for full-width elements
 
-## Cleanup Pattern in Controller
+## Cleanup pattern in controller
 Critical for memory management and avoiding leaks.
 
 ```javascript
@@ -133,7 +133,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Animation Usage
+## Animation usage
 Using `Ti.UI.createAnimation()` for UI transformations.
 
 ```javascript
@@ -153,7 +153,7 @@ function shakeError(element) {
 }
 ```
 
-## Complete CRUD Example
+## Complete crud example
 
 ```javascript
 // lib/services/productService.js
@@ -301,7 +301,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## ListView with Search and Filter
+## ListView with search and filter
 
 ```xml
 <!-- views/contacts/list.xml -->
@@ -455,7 +455,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Form with Validation Example
+## Form with validation example
 
 ```xml
 <!-- views/auth/register.xml -->
@@ -696,7 +696,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Tab-Based Navigation Example
+## Tab-based navigation example
 
 ```xml
 <!-- views/main.xml -->

package/skills/ti-expert/references/migration-patterns.md

@@ -1,6 +1,6 @@
-# Migration Patterns for Legacy Titanium Apps
+# Migration patterns for legacy Titanium apps
 
-## Assessment Checklist
+## Assessment checklist
 
 Before migrating, evaluate the current codebase:
 
@@ -12,11 +12,11 @@ Before migrating, evaluate the current codebase:
 | Navigation  | Direct `Alloy.createController().getView().open()` | Navigation service                            |
 | Data        | Scattered `Ti.App.Properties`, no collections      | Centralized state + Collections               |
 
-## Phase 1: TSS Organization
+## Phase 1: TSS organization
 
 **Goal**: Migrate from inline styling and scattered styles to well-organized TSS files.
 
-### Step 1: Audit Existing Styles
+### Step 1: audit existing styles
 
 Find all inline attributes and consolidate into TSS files:
 ```bash
@@ -26,7 +26,7 @@ grep -r 'font=' app/views/
 grep -r 'color=' app/views/
 ```
 
-### Step 2: Move Inline Attributes to TSS
+### Step 2: move inline attributes to TSS
 
 ```xml
 <!-- BEFORE: Inline attributes -->
@@ -48,7 +48,7 @@ grep -r 'color=' app/views/
 "#title": { color: "#333", font: { fontSize: 18, fontWeight: "bold" } }
 ```
 
-### Step 3: Organize TSS Structure
+### Step 3: organize TSS structure
 
 1. Use `app.tss` for global styles (shared across all views)
 2. Use per-controller TSS files for view-specific styles
@@ -59,11 +59,11 @@ grep -r 'color=' app/views/
 ".btn-primary": { backgroundColor: '#2563eb', color: '#fff', height: 44, borderRadius: 8 }
 ```
 
-## Phase 2: Service Layer Extraction
+## Phase 2: service layer extraction
 
 **Goal**: Move business logic from controllers to services.
 
-### Identify Fat Controllers
+### Identify fat controllers
 
 Signs of a fat controller:
 - API calls with `Ti.Network.createHTTPClient`
@@ -71,7 +71,7 @@ Signs of a fat controller:
 - Native module interactions
 - 100+ lines of code
 
-### Extract to Services
+### Extract to services
 
 ```javascript
 // BEFORE: Fat controller
@@ -117,18 +117,18 @@ async function loadProfile() {
 }
 ```
 
-## Phase 3: Event System Migration
+## Phase 3: event system migration
 
 **Goal**: Replace `Ti.App.fireEvent` with Backbone.Events.
 
-### Step 1: Create Event Bus
+### Step 1: create event bus
 
 ```javascript
 // alloy.js
 Alloy.Events = _.clone(Backbone.Events)
 ```
 
-### Step 2: Find All Ti.App Event Usage
+### Step 2: find all Ti.App event usage
 
 ```bash
 # Find all Ti.App.fireEvent calls
@@ -136,7 +136,7 @@ grep -r "Ti.App.fireEvent" app/controllers/
 grep -r "Ti.App.addEventListener" app/controllers/
 ```
 
-### Step 3: Migrate Events
+### Step 3: migrate events
 
 ```javascript
 // BEFORE: Ti.App events (memory leaks, no cleanup)
@@ -151,7 +151,7 @@ Alloy.Events.on('user:updated', onUserUpdated)
 Alloy.Events.off('user:updated', onUserUpdated)
 ```
 
-### Step 4: Add Cleanup Functions
+### Step 4: add cleanup functions
 
 Every controller that listens to events needs cleanup:
 
@@ -171,11 +171,11 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Phase 4: Navigation Service
+## Phase 4: navigation service
 
 **Goal**: Centralize navigation with automatic cleanup.
 
-### Step 1: Create Navigation Service
+### Step 1: create navigation service
 
 ```javascript
 // lib/services/navigation.js
@@ -216,7 +216,7 @@ exports.getStack = function() {
 }
 ```
 
-### Step 2: Replace Direct Navigation
+### Step 2: replace direct navigation
 
 ```javascript
 // BEFORE: Direct navigation (no cleanup)
@@ -227,22 +227,22 @@ const navigation = require('services/navigation')
 navigation.open('detail', { id: 123 })
 ```
 
-## Phase 5: State Management
+## Phase 5: state management
 
 **Goal**: Centralize app state for consistency.
 
-### Step 1: Identify Scattered State
+### Step 1: identify scattered state
 
 Look for:
 - `Ti.App.Properties.getString/setString` scattered across controllers
 - `Alloy.Globals` for sharing data
 - Direct collection access from multiple controllers
 
-### Step 2: Create State Store
+### Step 2: create state store
 
 See [state-management.md](state-management.md) for full implementation.
 
-### Step 3: Migrate State Access
+### Step 3: migrate state access
 
 ```javascript
 // BEFORE: Scattered state
@@ -261,7 +261,7 @@ appStore.setState({ user })
 const { user } = appStore.getState()
 ```
 
-## Migration Order
+## Migration order
 
 Recommended sequence to minimize risk:
 
@@ -271,7 +271,7 @@ Recommended sequence to minimize risk:
 4. **Event System** - Replace Ti.App events
 5. **State Management** - Last, as it touches everything
 
-## Rollback Strategy
+## Rollback strategy
 
 For each phase:
 
@@ -289,7 +289,7 @@ For each phase:
 Alloy.Events.trigger('user:updated', data)
 ```
 
-## Common Migration Pitfalls
+## Common migration pitfalls
 
 | Pitfall                          | Consequence         | Prevention                           |
 | -------------------------------- | ------------------- | ------------------------------------ |

package/skills/ti-expert/references/patterns.md

@@ -1,6 +1,6 @@
-# Architectural Patterns for Titanium + Alloy
+# Architectural patterns for Titanium + Alloy
 
-## 1. Native Module Abstraction (Wrapper)
+## 1. Native module abstraction (Wrapper)
 
 **Use when:** Using native modules like Maps, Biometrics, or specialized Media players.
 
@@ -41,7 +41,7 @@ exports.BiometricService = {
 }
 ```
 
-## 2. Repository Pattern for Data
+## 2. Repository pattern for data
 
 **Use when:** Complex data access, multiple data sources, or need to abstract SQLite/API.
 
@@ -98,7 +98,7 @@ exports.UserRepository = {
 }
 ```
 
-## 3. Service Layer Pattern
+## 3. Service layer pattern
 
 **Use when:** Business logic, orchestrating multiple operations.
 
@@ -148,7 +148,7 @@ exports.AuthService = {
 }
 ```
 
-## 4. Event Bus for Decoupling
+## 4. Event bus for decoupling
 
 **Use when:** Decoupled modules need to communicate without knowing about each other.
 
@@ -194,7 +194,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## 5. Factory Pattern for Dynamic Views
+## 5. Factory pattern for dynamic views
 
 **Use when:** Creating similar views with different configurations.
 
@@ -239,7 +239,7 @@ exports.createProductCard = function(product) {
 }
 ```
 
-## 6. Navigation Service Pattern
+## 6. Navigation service pattern
 
 **Use when:** Centralizing navigation with automatic cleanup and history management.
 
@@ -303,7 +303,7 @@ exports.Navigation = {
 }
 ```
 
-## 7. Collection Binding Pattern
+## 7. Collection binding pattern
 
 **Use when:** Binding API data to ListViews with automatic updates.
 
@@ -346,7 +346,7 @@ $.cleanup = cleanup
 </ListView>
 ```
 
-## 8. Cleanup Pattern
+## 8. Cleanup pattern
 
 **Use when:** Preventing memory leaks by removing global listeners.
 
@@ -395,7 +395,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## 9. Singleton Service Pattern
+## 9. Singleton service pattern
 
 **Use when:** Services that should have only one instance app-wide.
 

package/skills/ti-expert/references/performance-listview.md

@@ -1,12 +1,12 @@
-# ListView & ScrollView Performance
+# ListView & ScrollView performance
 
-## Critical Rules
+## Critical rules
 
 1. **NEVER use `Ti.UI.SIZE` in ListView items** - Causes layout recalculation on every scroll
 2. **ALWAYS use fixed heights** - Pre-calculated heights enable fast scrolling
 3. **USE templates** - Reuse view instances instead of creating new ones
 
-## Optimized ListView Template
+## Optimized ListView template
 
 ```xml
 <!-- views/user/list.xml -->
@@ -47,7 +47,7 @@
 - Use margins on children for spacing (NOT padding on parent)
 - Use `width: Ti.UI.FILL, height: Ti.UI.FILL` for full width + height
 
-## Efficient Data Binding
+## Efficient data binding
 
 ```javascript
 // controllers/feed/list.js
@@ -83,7 +83,7 @@ function formatTimestamp(timestamp) {
 }
 ```
 
-## Image Loading & Caching
+## Image loading & caching
 
 ```javascript
 // lib/services/imageCache.js
@@ -147,9 +147,9 @@ exports.ImageCache = {
 }
 ```
 
-## ScrollView Performance
+## ScrollView performance
 
-### Optimizing Large ScrollViews
+### Optimizing large scrollviews
 
 ```xml
 <!-- Avoid: Creating many views at once -->
@@ -163,7 +163,7 @@ exports.ImageCache = {
 </ListView>
 ```
 
-### When You Must Use ScrollView
+### When you must use ScrollView
 
 ```javascript
 // Lazy load content sections
@@ -211,7 +211,7 @@ function loadSection(sectionId) {
 }
 ```
 
-## ScrollView Memory Management
+## ScrollView memory management
 
 ```javascript
 // Release images when scrolled far away
@@ -239,13 +239,13 @@ function onScroll(e) {
 }
 ```
 
-## Performance Checklist (UI)
+## Performance checklist (UI)
 
-| Area         | Check                              |
+| Area | Check |
 | ------------ | ---------------------------------- |
-| **ListView** | Fixed heights on all templates     |
+| **ListView** | Fixed heights on all templates |
 | **ListView** | Using templates, not dynamic views |
-| **ListView** | Image pre-sizing and caching       |
-| **Scroll**   | Lazy loading content sections      |
-| **Scroll**   | Release off-screen images          |
-| **Images**   | Resized appropriately for display  |
+| **ListView** | Image pre-sizing and caching |
+| **Scroll** | Lazy loading content sections |
+| **Scroll** | Release off-screen images |
+| **Images** | Resized appropriately for display |