@maccesar/titools 2.2.3 → 2.2.8

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

@@ -1,8 +1,8 @@
-# Performance Optimization: Bridge, Memory, Animation & Timing
+# Performance optimization: bridge, memory, animation & timing
 
-## Bridge Optimization
+## Bridge optimization
 
-### Minimize Bridge Crossings
+### Minimize bridge crossings
 
 Every JavaScript -> Native call crosses a bridge. Minimize these:
 
@@ -17,7 +17,7 @@ const displayCaps = Ti.Platform.displayCaps
 const { platformWidth, platformHeight, dpi } = displayCaps
 ```
 
-### Batch UI Updates
+### Batch UI updates
 
 ```javascript
 // BAD: Multiple bridge crossings
@@ -35,7 +35,7 @@ $.nameLabel.applyProperties({
 })
 ```
 
-### Use TSS Files Instead of Inline Attributes
+### Use TSS files instead of inline attributes
 
 ```xml
 <!-- BAD: Inline styling = scattered and hard to maintain -->
@@ -50,9 +50,9 @@ $.nameLabel.applyProperties({
 "#helloLabel": { width: 200, height: 40, color: '#000', font: { fontSize: 16 } }
 ```
 
-## Memory Management
+## Memory management
 
-### Controller Cleanup Pattern
+### Controller cleanup pattern
 
 ```javascript
 // controllers/detail.js
@@ -106,7 +106,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Image Memory Management
+## Image memory management
 
 ```javascript
 // lib/services/imageManager.js
@@ -150,7 +150,7 @@ exports.ImageManager = {
 }
 ```
 
-## Lazy Loading Pattern
+## Lazy loading pattern
 
 ```javascript
 // controllers/feed/list.js
@@ -207,7 +207,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Database Performance
+## Database performance
 
 ```javascript
 // lib/services/database.js
@@ -284,7 +284,7 @@ exports.DB = {
 }
 ```
 
-## Performance Monitoring
+## Performance monitoring
 
 ```javascript
 // lib/services/perfMonitor.js
@@ -343,9 +343,9 @@ renderUsers(users)
 measure.end()
 ```
 
-## Animation Performance
+## Animation performance
 
-### 60fps Animation Rules
+### 60fps animation rules
 
 ```javascript
 // Rule 1: Use native animations (not JavaScript intervals)
@@ -406,7 +406,7 @@ fadeIn($.modal, () => {
 })
 ```
 
-## Hardware-Accelerated Properties
+## Hardware-accelerated properties
 
 ```javascript
 // These properties are GPU-accelerated (fast):
@@ -438,7 +438,7 @@ const badAnimation = Ti.UI.createAnimation({
 })
 ```
 
-## Animation Cleanup
+## Animation cleanup
 
 ```javascript
 // Always remove animation listeners
@@ -471,9 +471,9 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Debouncing and Throttling
+## Debouncing and throttling
 
-### Debounce Pattern
+### Debounce pattern
 
 Use when you want to wait for the user to stop an action before processing.
 
@@ -517,7 +517,7 @@ function cleanup() {
 }
 ```
 
-### Throttle Pattern
+### Throttle pattern
 
 Use when you want to limit how often a function can run.
 
@@ -572,18 +572,18 @@ function cleanup() {
 }
 ```
 
-### Common Use Cases
+### Common use cases
 
-| Pattern  | Use Case         | Delay        |
+| Pattern | Use Case | Delay |
 | -------- | ---------------- | ------------ |
-| Debounce | Search input     | 300ms        |
-| Debounce | Auto-save        | 1000ms       |
-| Debounce | Window resize    | 150ms        |
-| Throttle | Scroll events    | 50-100ms     |
+| Debounce | Search input | 300ms |
+| Debounce | Auto-save | 1000ms |
+| Debounce | Window resize | 150ms |
+| Throttle | Scroll events | 50-100ms |
 | Throttle | Mouse/touch move | 16ms (60fps) |
-| Throttle | API polling      | 5000ms+      |
+| Throttle | API polling | 5000ms+ |
 
-### Combined Pattern for Real-time + Final
+### Combined pattern for real-time + final
 
 ```javascript
 // Show immediate feedback while typing, but only search when done
@@ -620,20 +620,20 @@ function cleanup() {
 }
 ```
 
-## Performance Checklist
+## Performance checklist
 
-| Area          | Check                                   |
+| Area | Check |
 | ------------- | --------------------------------------- |
-| **Bridge**    | Cached Ti.Platform properties           |
-| **Bridge**    | Using applyProperties for updates       |
-| **Bridge**    | TSS styles instead of inline attributes |
-| **Memory**    | All global listeners cleaned up         |
-| **Memory**    | Heavy objects nulled in cleanup         |
-| **Memory**    | Images resized appropriately            |
-| **Database**  | Using transactions for batch ops        |
-| **Database**  | Indexes on frequently queried columns   |
-| **Database**  | ResultSets and DB handles closed        |
-| **Animation** | Using native animations, not intervals  |
-| **Animation** | GPU-accelerated properties preferred    |
-| **Timing**    | Debounce on search/input                |
-| **Timing**    | Throttle on scroll/touch events         |
+| **Bridge** | Cached Ti.Platform properties |
+| **Bridge** | Using applyProperties for updates |
+| **Bridge** | TSS styles instead of inline attributes |
+| **Memory** | All global listeners cleaned up |
+| **Memory** | Heavy objects nulled in cleanup |
+| **Memory** | Images resized appropriately |
+| **Database** | Using transactions for batch ops |
+| **Database** | Indexes on frequently queried columns |
+| **Database** | ResultSets and DB handles closed |
+| **Animation** | Using native animations, not intervals |
+| **Animation** | GPU-accelerated properties preferred |
+| **Timing** | Debounce on search/input |
+| **Timing** | Throttle on scroll/touch events |

package/skills/ti-expert/references/security-device.md

@@ -1,8 +1,8 @@
-# Device Security: Biometrics, Deep Links & Integrity
+# Device security: biometrics, deep links & integrity
 
-## Biometric Authentication
+## Biometric authentication
 
-### Using ti.identity Module
+### Using ti.identity module
 
 ```javascript
 // lib/services/biometricService.js
@@ -83,7 +83,7 @@ exports.BiometricService = {
 }
 ```
 
-## Biometric Login Flow
+## Biometric login flow
 
 ```javascript
 // controllers/auth/login.js
@@ -148,9 +148,9 @@ async function onLoginSuccess(user) {
 }
 ```
 
-## Deep Link Security
+## Deep link security
 
-### Validating Deep Links
+### Validating deep links
 
 ```javascript
 // lib/services/deepLinkService.js
@@ -311,7 +311,7 @@ exports.DeepLinkService = {
 }
 ```
 
-## Registering Deep Link Handler
+## Registering deep link handler
 
 ```javascript
 // alloy.js
@@ -346,9 +346,9 @@ if (OS_ANDROID) {
 }
 ```
 
-## Jailbreak/Root Detection
+## Jailbreak/Root detection
 
-### Detection Service
+### Detection service
 
 ```javascript
 // lib/services/securityService.js
@@ -528,7 +528,7 @@ exports.SecurityService = {
 }
 ```
 
-## Integrating Security Checks
+## Integrating security checks
 
 ```javascript
 // alloy.js
@@ -548,17 +548,17 @@ setInterval(() => {
 }, 5 * 60 * 1000) // Every 5 minutes
 ```
 
-## Security Checklist
+## Security checklist
 
-| Category       | Check                      | Implementation           |
+| Category | Check | Implementation |
 | -------------- | -------------------------- | ------------------------ |
-| **Biometrics** | Use ti.identity for auth   | BiometricService wrapper |
-| **Biometrics** | Never store biometric data | System handles storage   |
-| **Biometrics** | Fallback to password       | Always offer alternative |
-| **Deep Links** | Whitelist allowed schemes  | ALLOWED_SCHEMES constant |
-| **Deep Links** | Whitelist allowed hosts    | ALLOWED_HOSTS constant   |
-| **Deep Links** | Sanitize all parameters    | _sanitizeParams()        |
-| **Deep Links** | Check auth requirements    | requiresAuth per route   |
-| **Integrity**  | Check for jailbreak/root   | checkDeviceIntegrity()   |
-| **Integrity**  | Define security policy     | block/restrict/warn      |
-| **Integrity**  | Log security events        | Always log compromises   |
+| **Biometrics** | Use ti.identity for auth | BiometricService wrapper |
+| **Biometrics** | Never store biometric data | System handles storage |
+| **Biometrics** | Fallback to password | Always offer alternative |
+| **Deep Links** | Whitelist allowed schemes | ALLOWED_SCHEMES constant |
+| **Deep Links** | Whitelist allowed hosts | ALLOWED_HOSTS constant |
+| **Deep Links** | Sanitize all parameters | _sanitizeParams() |
+| **Deep Links** | Check auth requirements | requiresAuth per route |
+| **Integrity** | Check for jailbreak/root | checkDeviceIntegrity() |
+| **Integrity** | Define security policy | block/restrict/warn |
+| **Integrity** | Log security events | Always log compromises |

package/skills/ti-expert/references/security-fundamentals.md

@@ -1,6 +1,6 @@
-# Security Fundamentals for Titanium Mobile Apps
+# Security fundamentals for Titanium mobile apps
 
-## Token Storage Strategy
+## Token storage strategy
 
 **NEVER store tokens in:** `Ti.App.Properties` (plaintext), localStorage, or files.
 
@@ -56,7 +56,7 @@ exports.TokenStorage = {
 }
 ```
 
-## Certificate Pinning
+## Certificate pinning
 
 Prevent man-in-the-middle attacks by pinning SSL certificates:
 
@@ -100,7 +100,7 @@ exports.createPinnedClient = function() {
 </ti:app>
 ```
 
-## Data Encryption at Rest
+## Data encryption at rest
 
 ```javascript
 // lib/services/encryption.js
@@ -151,7 +151,7 @@ module.exports = class SecureCache {
 }
 ```
 
-## Secure HTTP Communication
+## Secure HTTP communication
 
 ```javascript
 // lib/api/secureClient.js
@@ -205,7 +205,7 @@ exports.createSecureClient = function(baseUrl) {
 }
 ```
 
-## Authentication Token Refresh Pattern
+## Authentication token refresh pattern
 
 ```javascript
 // lib/services/authService.js
@@ -238,7 +238,7 @@ function scheduleTokenRefresh(expiresIn) {
 }
 ```
 
-## Input Validation
+## Input validation
 
 ```javascript
 // lib/services/validator.js
@@ -268,17 +268,17 @@ exports.Validator = {
 }
 ```
 
-## OWASP Mobile Security Checklist
+## Owasp mobile security checklist
 
-| Category             | Check                       | Implementation                     |
+| Category | Check | Implementation |
 | -------------------- | --------------------------- | ---------------------------------- |
-| **Data Storage**     | Credentials stored securely | Keychain/KeyStore for tokens       |
-| **Data Storage**     | Sensitive data encrypted    | AES-256 for cached data            |
-| **Communication**    | HTTPS only                  | `validatesSecureCertificate: true` |
-| **Communication**    | Certificate pinning         | SSL pinning enabled                |
-| **Authentication**   | Token refresh               | Auto-refresh before expiry         |
-| **Authentication**   | Session timeout             | Auto-logout after inactivity       |
-| **Input Validation** | Server-side validation      | Never trust client input           |
-| **Input Validation** | Sanitize user input         | Remove XSS patterns                |
-| **Cryptography**     | No hardcoded keys           | Keys from secure storage           |
-| **Cryptography**     | Use standard algorithms     | AES-256, SHA-256                   |
+| **Data Storage** | Credentials stored securely | Keychain/KeyStore for tokens |
+| **Data Storage** | Sensitive data encrypted | AES-256 for cached data |
+| **Communication** | HTTPS only | `validatesSecureCertificate: true` |
+| **Communication** | Certificate pinning | SSL pinning enabled |
+| **Authentication** | Token refresh | Auto-refresh before expiry |
+| **Authentication** | Session timeout | Auto-logout after inactivity |
+| **Input Validation** | Server-side validation | Never trust client input |
+| **Input Validation** | Sanitize user input | Remove XSS patterns |
+| **Cryptography** | No hardcoded keys | Keys from secure storage |
+| **Cryptography** | Use standard algorithms | AES-256, SHA-256 |

package/skills/ti-expert/references/state-management.md

@@ -1,6 +1,6 @@
-# State Management Patterns
+# State management patterns
 
-## The Problem
+## The problem
 
 As apps grow, state gets scattered:
 - `Alloy.Collections` scattered across controllers
@@ -13,7 +13,7 @@ This leads to:
 - Inconsistent UI updates
 - Difficult debugging
 
-## Solution: Centralized State Store
+## Solution: centralized state store
 
 Create a single source of truth using Backbone.Events:
 
@@ -76,7 +76,7 @@ class StateStore {
 exports.appStore = new StateStore()
 ```
 
-## State Store Usage
+## State store usage
 
 ### Initialization in alloy.js
 
@@ -101,7 +101,7 @@ function initAppStore() {
 initAppStore()
 ```
 
-### Using State in Controllers
+### Using state in controllers
 
 ```javascript
 // controllers/home/index.js
@@ -139,7 +139,7 @@ function cleanup() {
 }
 ```
 
-### Updating State from Services
+### Updating state from services
 
 ```javascript
 // lib/services/authService.js
@@ -189,7 +189,7 @@ exports.logout = async function() {
 }
 ```
 
-## Service Layer State Caching
+## Service layer state caching
 
 Services can maintain their own cached state:
 
@@ -229,7 +229,7 @@ class UserService {
 exports.userService = new UserService()
 ```
 
-## Collections vs State Store
+## Collections vs state store
 
 **Use Alloy.Collections when:**
 - Data is list-based (users, items, messages)
@@ -254,7 +254,7 @@ Alloy.Collections.users.fetch({
 })
 ```
 
-## State Synchronization Pattern
+## State synchronization pattern
 
 When state needs to sync with server:
 
@@ -278,19 +278,19 @@ Ti.App.addEventListener('resume', () => {
 })
 ```
 
-## Anti-Patterns
+## Anti-patterns
 
-| Anti-Pattern                          | Why It's Bad                 | Solution                                 |
+| Anti-Pattern | Why It's Bad | Solution |
 | ------------------------------------- | ---------------------------- | ---------------------------------------- |
-| `Ti.App.fireEvent` for state          | No cleanup, memory leaks     | Use StateStore with `offChange`          |
-| Direct collection mutation            | Bypasses reactivity          | Use collection methods (`add`, `remove`) |
-| State in multiple places              | Inconsistency bugs           | Single source of truth                   |
-| Global variables (`Alloy.Globals`)    | No reactivity, hard to track | Use StateStore                           |
-| Controller-to-controller direct calls | Tight coupling               | Use StateStore or events                 |
+| `Ti.App.fireEvent` for state | No cleanup, memory leaks | Use StateStore with `offChange` |
+| Direct collection mutation | Bypasses reactivity | Use collection methods (`add`, `remove`) |
+| State in multiple places | Inconsistency bugs | Single source of truth |
+| Global variables (`Alloy.Globals`) | No reactivity, hard to track | Use StateStore |
+| Controller-to-controller direct calls | Tight coupling | Use StateStore or events |
 
-## Persistence Strategies
+## Persistence strategies
 
-### Ti.App.Properties (Simple Key-Value)
+### Ti.App.Properties (Simple Main-Value)
 
 Best for: User preferences, flags, simple settings.
 
@@ -415,7 +415,7 @@ exports.Database = {
 }
 ```
 
-### Hybrid Strategy (Recommended)
+### Hybrid strategy (Recommended)
 
 ```javascript
 // lib/services/stateStore.js
@@ -470,20 +470,20 @@ exports.appStore = {
 }
 ```
 
-### Choosing a Strategy
+### Choosing a strategy
 
-| Data Type          | Strategy            | Reason                 |
+| Data Type | Strategy | Reason |
 | ------------------ | ------------------- | ---------------------- |
-| User preferences   | Ti.App.Properties   | Simple key-value, fast |
-| Auth tokens        | Keychain/KeyStore   | Security               |
-| User profile       | Properties + Secure | Mixed sensitivity      |
-| Lists (100+ items) | SQLite              | Query, pagination      |
-| Offline queue      | SQLite              | Durability, FIFO       |
-| Cache              | In-memory + SQLite  | Speed + persistence    |
+| User preferences | Ti.App.Properties | Simple main-value, fast |
+| Auth tokens | Keychain/KeyStore | Security |
+| User profile | Properties + Secure | Mixed sensitivity |
+| Lists (100+ items) | SQLite | Query, pagination |
+| Offline queue | SQLite | Durability, FIFO |
+| Cache | In-memory + SQLite | Speed + persistence |
 
-## State Middleware
+## State middleware
 
-### Logger Middleware
+### Logger middleware
 
 ```javascript
 // lib/services/stateStore.js
@@ -569,7 +569,7 @@ appStore
   .use(persistMiddleware)
 ```
 
-### Action-Based State Updates
+### Action-based state updates
 
 ```javascript
 // lib/services/stateStore.js
@@ -639,9 +639,9 @@ appStore.dispatch('user/login', { user: userData, token: authToken })
 appStore.dispatch('cart/add', { item: product })
 ```
 
-## State Debugging
+## State debugging
 
-### Debug Helper
+### Debug helper
 
 ```javascript
 // lib/services/stateDebug.js
@@ -723,7 +723,7 @@ const debugMiddleware = (oldState, action, newState) => {
 appStore.use(debugMiddleware)
 ```
 
-### Development Panel
+### Development panel
 
 ```javascript
 // controllers/debug/stateViewer.js (Development only)

package/skills/ti-expert/references/testing-e2e-ci.md

@@ -1,6 +1,6 @@
-# End-to-End Testing & CI/CD
+# End-to-end testing & CI/CD
 
-## Appium Setup
+## Appium setup
 
 ```bash
 # Install Appium
@@ -11,7 +11,7 @@ appium driver install xcuitest  # iOS
 appium driver install uiautomator2  # Android
 ```
 
-## Appium Configuration
+## Appium configuration
 
 ```javascript
 // e2e/config/capabilities.js
@@ -34,7 +34,7 @@ exports.android = {
 }
 ```
 
-## WebdriverIO Integration
+## Webdriverio integration
 
 ```javascript
 // e2e/wdio.conf.js
@@ -72,7 +72,7 @@ exports.config = {
 }
 ```
 
-## E2E Test Example
+## E2E test example
 
 ```javascript
 // e2e/specs/login.spec.js
@@ -125,7 +125,7 @@ describe('Login Flow', () => {
 })
 ```
 
-## Adding Accessibility IDs for Testing
+## Adding accessibility IDs for testing
 
 ```xml
 <!-- views/auth/login.xml -->
@@ -145,7 +145,7 @@ if (Alloy.CFG.debug) {
 }
 ```
 
-## Page Object Pattern
+## Page object pattern
 
 ```javascript
 // e2e/pages/LoginPage.js
@@ -184,9 +184,9 @@ describe('Login Flow', () => {
 })
 ```
 
-## CI/CD Integration
+## CI/CD integration
 
-### GitHub Actions Workflow
+### Github actions workflow
 
 ```yaml
 # .github/workflows/ci.yml
@@ -348,7 +348,7 @@ jobs:
           path: e2e/screenshots/
 ```
 
-## Fastlane Integration
+## Fastlane integration
 
 ```ruby
 # fastlane/Fastfile
@@ -389,7 +389,7 @@ platform :android do
 end
 ```
 
-## Package.json Scripts
+## Package.json scripts
 
 ```json
 {
@@ -408,25 +408,25 @@ end
 }
 ```
 
-## Branch Protection Rules
+## Branch protection rules
 
 Configure in GitHub repository settings:
 
-| Rule                              | Setting                                    |
+| Rule | Setting |
 | --------------------------------- | ------------------------------------------ |
-| Require pull request reviews      | 1 approval required                        |
-| Require status checks             | lint, unit-tests, build-ios, build-android |
-| Require branches to be up to date | Yes                                        |
-| Include administrators            | Yes                                        |
+| Require pull request reviews | 1 approval required |
+| Require status checks | lint, unit-tests, build-ios, build-android |
+| Require branches to be up to date | Yes |
+| Include administrators | Yes |
 
-## Testing Best Practices Summary
+## Testing best practices summary
 
-| Area                  | Practice                                   |
+| Area | Practice |
 | --------------------- | ------------------------------------------ |
-| **Unit Tests**        | Test business logic in services/helpers    |
+| **Unit Tests** | Test business logic in services/helpers |
 | **Integration Tests** | Test controller flows with mocked services |
-| **E2E Tests**         | Test critical user journeys                |
-| **Coverage**          | Aim for 80%+ on services, 60%+ overall     |
-| **CI Pipeline**       | Run lint -> unit tests -> build -> E2E     |
-| **Artifacts**         | Save screenshots on failure                |
-| **Notifications**     | Slack/email on build failures              |
+| **E2E Tests** | Test critical user journeys |
+| **Coverage** | Aim for 80%+ on services, 60%+ overall |
+| **CI Pipeline** | Run lint -> unit tests -> build -> E2E |
+| **Artifacts** | Save screenshots on failure |
+| **Notifications** | Slack/email on build failures |