@maccesar/titools 2.2.4 → 2.2.8

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

@@ -1,31 +1,31 @@
-# Titanium Alloy Anti-Patterns
+# Titanium Alloy anti-patterns
 
-## 1. Inline Styling Instead of TSS
+## 1. Inline styling instead of TSS
 **Symptom:** Using inline attributes like `backgroundColor="#fff"` directly in XML views.
 **Problem:** Inline attributes make theme changes impossible and scatter visual definitions across views.
 **Solution:** Define styles in TSS files using IDs or class selectors.
 
-## 2. Fat Controllers
+## 2. Fat controllers
 **Symptom:** Controllers with 100+ lines handling logic, API, and UI.
 **Solution:** Delegate business logic to `lib/services/` and API calls to `lib/api/`.
 
-## 3. Memory Leaks (Missing Cleanup)
+## 3. Memory leaks (Missing Cleanup)
 **Symptom:** Adding `Ti.App` or `Alloy.Collections` listeners without a `cleanup()` function.
 **Solution:** Always implement `$.cleanup = cleanup` and remove listeners there.
 
-## 4. Direct Native Module Calls
+## 4. Direct native module calls
 **Symptom:** Calling `require('ti.module')` directly in a controller.
 **Solution:** Wrap it in a service in `lib/services/` (e.g., `audioService.js`).
 
-## 5. Direct Controller Navigation
+## 5. Direct controller navigation
 **Symptom:** `Alloy.createController('name').getView().open()`.
 **Solution:** Use a Navigation Service to centralize `open/close` and trigger the `cleanup()` function automatically.
 
-## 6. Complex Matrix Animations
+## 6. Complex matrix animations
 **Symptom:** Manual use of `Ti.UI.create2DMatrix()` for simple animations.
 **Solution:** Use `Ti.UI.createAnimation()` for opacity, transform, and duration-based animations. Reserve 2D Matrix for complex multi-property transforms.
 
-## 7. Hardcoded Strings & Missing a11y
+## 7. Hardcoded strings & missing a11y
 **Symptom:** `text="Login"` instead of `text="L('login')"`, or missing `accessibilityLabel`.
 **Solution:** Always use i18n and accessibility properties.
 
@@ -35,9 +35,9 @@
 
 ---
 
-## Titanium Layout Anti-Patterns
+## Titanium layout anti-patterns
 
-## 9. Padding on Container Views
+## 9. Padding on container views
 **Symptom:** Setting `padding` on View, Window, ScrollView, or TableView.
 **Problem:** Base container elements don't support padding in Titanium.
 **Solution:** Use margins on children instead:
@@ -49,17 +49,17 @@
 "#childLabel": { left: 16, top: 16, right: 16 }
 ```
 
-## 10. Redundant Composite Layout
+## 10. Redundant composite layout
 **Symptom:** Adding `layout: 'composite'` to Views.
 **Problem:** Composite (absolute positioning) is the DEFAULT layout. Setting it is redundant.
 **Solution:** Omit `layout` for composite, only specify `layout: 'horizontal'` or `layout: 'vertical'` when needed.
 
-## 11. Using `lib/` Prefix in Require Statements
+## 11. Using `lib/` prefix in require statements
 **Symptom:** `const service = require('lib/services/picsum')`
 **Problem:** Alloy flattens the `lib/` folder during build. Files in `app/lib/services/` become `Resources/iphone/services/`.
 **Solution:** Omit the `lib/` prefix: `const service = require('services/picsum')`
 
-## 12. Wrong Window ID in Controller
+## 12. Wrong window ID in controller
 **Symptom:** Using `$.index.open()` when the Window has `id="mainWindow"`.
 **Problem:** Alloy generates `$` references from XML IDs. If Window is `id="mainWindow"`, `$.index` doesn't exist.
 **Solution:** Match the ID: `$.mainWindow.open()`
@@ -69,7 +69,7 @@
 **Problem:** This API doesn't exist in Titanium. Causes "invalid method" error.
 **Solution:** Use `Ti.UI.createAlertDialog` for simple messages, or create custom toast views.
 
-## 14. Using Nonexistent iOS Share APIs
+## 14. Using nonexistent iOS share APIs
 **Symptom:** `Ti.UI.iOS.createActivityPopover` or `alloy/social` with wrong methods.
 **Problem:** These APIs either don't exist or have changed. Causes runtime errors.
 **Solution:**
@@ -78,7 +78,7 @@
 
 ---
 
-## Quick Reference Table
+## Quick reference table
 
 | Anti-Pattern            | Why It Fails             | Correct Approach      |
 | ----------------------- | ------------------------ | --------------------- |

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

@@ -1,12 +1,12 @@
-# CLI Expert Strategies & TiNy
+# CLI expert strategies & TiNy
 
 Mastering the command line is essential for a Titanium expert. This guide covers advanced workflows, optimization techniques, and the use of **TiNy (`tn`)** for efficient development.
 
-## The Expert Workflow
+## The expert workflow
 
 An expert doesn't just run `ti build`. They optimize for speed, reliability, and automation.
 
-### 1. The "Inner Loop" Optimization
+### 1. The "inner loop" optimization
 Reduce the time between writing code and seeing it on the device.
 
 - **LiveView**: Use `--liveview` for near-instant UI updates without full recompilation.
@@ -22,27 +22,27 @@ Reduce the time between writing code and seeing it on the device.
   ti build -p ios --skip-js-minify
   ```
 
-### 2. Precise Cleaning
+### 2. Precise cleaning
 Don't use `ti clean` as a first resort (it's slow).
 - **Targeted Clean**: If Alloy isn't reflecting changes, try deleting `Resources/` and `build/` manually or use `ti clean -p <platform>`.
-- **Pre-Production**: Always run a full `ti clean` before a production/App Store build to ensure no stale assets are included.
+- **Pre-Production**: Always run a full `ti clean` before a production/App Store build to make sure no stale assets are included.
 
-### 3. Advanced Debugging
+### 3. Advanced debugging
 - **Trace Logging**: Use `--log-level trace` when a build fails for mysterious reasons (e.g., a broken hook or native module issue).
 - **Build Logs**: Check `build/build.log` for the full output of the last build process.
 
 ---
 
-## TiNy (`tn`): The Expert's Power Tool
+## TiNy (`tn`): the expert's power tool
 
 **TiNy** is a modern CLI wrapper for Titanium SDK that drastically reduces keystrokes and manages complex build configurations through "recipes".
 
-### Why Experts Use TiNy
+### Why experts use TiNy
 - **Speed**: `tn ios` vs `ti build -p ios -T simulator`.
-- **Consistency**: Recipes ensure every team member builds with the same flags.
+- **Consistency**: Recipes make sure every team member builds with the same flags.
 - **Device Management**: Easily target specific simulators/emulators by name.
 
-### Quick Start
+### Quick start
 1. **Install**: `npm install -g tn`
 2. **Repo**: https://github.com/jasonkneen/tn
 3. **Generate Recipes**: Detect all connected devices/simulators.
@@ -55,7 +55,7 @@ Don't use `ti clean` as a first resort (it's slow).
    tn pixel-8-pro-api-34
    ```
 
-### Expert Recipes
+### Expert recipes
 Recipes can be flags or options. Multiple recipes can be combined.
 
 | Command        | Expansion                           |
@@ -66,7 +66,7 @@ Recipes can be flags or options. Multiple recipes can be combined.
 | `tn playstore` | `--android --target dist-playstore` |
 | `tn watch`     | `--ios --launch-watch-app`          |
 
-### Customizing Your Workflow
+### Customizing your workflow
 - **Save Global Recipe**:
   ```bash
   tn save my-debug --ios --simulator --log-level trace --skip-js-minify
@@ -76,7 +76,7 @@ Recipes can be flags or options. Multiple recipes can be combined.
   tn project save release --playstore --keystore ./android/release.keystore
   ```
 
-### Composition & Placeholders
+### Composition & placeholders
 You can use `%s` as a placeholder in recipes for values:
 ```bash
 tn save ci -b --pp-uuid <UUID> --distribution-name "<NAME>" --ah --installr --installr-release-notes %s
@@ -87,7 +87,7 @@ tn ci "Fixed login bug"
 
 ---
 
-## Automation Integration
+## Automation integration
 
 Experts automate their builds using `package.json` scripts, often combining `ti` or `tn` with other tools.
 
@@ -103,7 +103,7 @@ Experts automate their builds using `package.json` scripts, often combining `ti`
 
 ---
 
-## Pro-Tips
+## Pro-tips
 - **SDK Switching**: Use `-s <version>` to test your app against a specific SDK version without changing your global default.
 - **Sim Focus**: Use `--no-sim-focus` if you want to keep your editor in focus while the simulator launches in the background.
 - **Concurrent Builds**: You can often build for iOS and Android simultaneously in different terminal tabs if your machine has the resources.

package/skills/ti-expert/references/code-conventions.md

@@ -1,6 +1,6 @@
-# TSS Styling & Code Conventions
+# TSS styling & code conventions
 
-## Module System: CommonJS (NOT ES6 modules)
+## Module system: CommonJS (NOT ES6 modules)
 
 Titanium uses **CommonJS** for modules. Do NOT use ES6 `import`/`export`:
 
@@ -14,7 +14,7 @@ import { Navigation } from 'services/navigation'
 export const Navigation = { /* ... */ }
 ```
 
-## ES6+ Features (Non-Module)
+## ES6+ features (Non-Module)
 
 Use `const`, `let`, destructuring, and template literals. Prefer arrow functions for callbacks and traditional functions for main logic.
 
@@ -25,7 +25,7 @@ const loadUserData = (userId) => {
 }
 ```
 
-## No Semicolons
+## No semicolons
 Omit semicolons at the end of lines (ASI handles it).
 
 ```javascript
@@ -35,7 +35,7 @@ const name = user.name
 
 ## Styling with TSS
 
-### TSS File Organization
+### TSS file organization
 
 Every controller can have a matching TSS file. Alloy also supports a global `app.tss`.
 
@@ -49,11 +49,11 @@ app/styles/
 ```
 
 **Style cascade (priority low → high):**
-1. `app.tss` — global base styles
-2. `<controller>.tss` — controller-specific styles
+1. `app.tss` , global base styles
+2. `<controller>.tss` , controller-specific styles
 3. Theme overrides (`app/themes/<name>/styles/`)
 
-### Selector Types
+### Selector types
 
 ```tss
 /* Element selector — applies to ALL elements of this type */
@@ -79,7 +79,7 @@ app/styles/
 | Class (`".card"`)   | Reusable patterns (3+ uses) | Cards, buttons, inputs |
 | ID (`"#name"`)      | Unique element positioning  | Specific layout needs  |
 
-### Class Selectors in XML
+### Class selectors in XML
 
 ```xml
 <!-- Combine multiple classes -->
@@ -91,7 +91,7 @@ app/styles/
 
 Classes defined in `app.tss` are available in every controller. Classes in `<controller>.tss` are only available in that controller.
 
-### ID + Class Combined
+### ID + class combined
 
 When an element has both an ID and classes, properties merge with ID taking priority:
 
@@ -108,7 +108,7 @@ When an element has both an ID and classes, properties merge with ID taking prio
 <Button id="saveButton" class="btn-primary" title="L('save')" />
 ```
 
-### Building a Design System in app.tss
+### Building a design system in app.tss
 
 Define reusable style classes for consistency:
 
@@ -162,7 +162,7 @@ Define reusable style classes for consistency:
 }
 ```
 
-### Complete Example
+### Complete example
 
 ```xml
 <!-- views/feature/list.xml -->
@@ -188,15 +188,15 @@ Define reusable style classes for consistency:
 }
 ```
 
-### Titanium Layout Rules
+### Titanium layout rules
 
-- Three layout modes: `layout: 'horizontal'`, `layout: 'vertical'`, and composite (default — no `layout` needed)
-- NO padding on container Views — use margins on children instead
+- Three layout modes: `layout: 'horizontal'`, `layout: 'vertical'`, and composite (default , no `layout` needed)
+- NO padding on container Views , use margins on children instead
 - `width: Ti.UI.FILL` fills available space, `width: Ti.UI.SIZE` wraps content
 - `height: Ti.UI.SIZE` is essential for vertical layouts with dynamic content
 - Use percentage widths (`width: '50%'`) for proportional column layouts
 
-## Platform & Device Modifiers
+## Platform & device modifiers
 Use TSS platform modifiers instead of writing conditional logic in controllers.
 
 ```tss
@@ -205,7 +205,7 @@ Use TSS platform modifiers instead of writing conditional logic in controllers.
 "#header[formFactor=tablet]": { top: 80 }
 ```
 
-## applyProperties() Pattern
+## applyProperties() pattern
 Use `applyProperties()` to batch UI updates and minimize bridge crossings for properties not managed by classes.
 
 ```javascript
@@ -215,7 +215,7 @@ $.nameLabel.applyProperties({
 })
 ```
 
-## ListView Templates
+## ListView templates
 Always use templates for performance. Never create views dynamically inside list rows.
 
 ```javascript
@@ -228,7 +228,7 @@ function renderUsers(users) {
 }
 ```
 
-## Memory Cleanup
+## Memory cleanup
 Always remove listeners to avoid memory leaks. Implement a `cleanup` function.
 
 ```javascript
@@ -238,7 +238,7 @@ function cleanup() {
 }
 ```
 
-## i18n and Accessibility (a11y)
+## i18n and accessibility (a11y)
 Use `L()` for all text and always include `accessibilityLabel` for interactive elements.
 
 ```xml
@@ -246,7 +246,7 @@ Use `L()` for all text and always include `accessibilityLabel` for interactive e
 <ImageView image="/images/user.png" accessibilityLabel="User Profile Picture" />
 ```
 
-## Percentage-Based Layouts
+## Percentage-based layouts
 Use percentage widths in TSS for responsive column layouts.
 
 ```xml
@@ -262,9 +262,9 @@ Use percentage widths in TSS for responsive column layouts.
 "#colRight": { width: '33.33%', backgroundColor: '#3b82f6' }
 ```
 
-## Naming Conventions
+## Naming conventions
 
-### Files and Folders
+### Files and folders
 ```
 app/
 ├── controllers/
@@ -286,7 +286,7 @@ app/
 │       └── settings.xml
 ```
 
-### Variables and Functions
+### Variables and functions
 ```javascript
 // Constants: UPPER_SNAKE_CASE
 const API_BASE_URL = 'https://api.example.com'
@@ -317,7 +317,7 @@ function onSearchChange(e) { /* ... */ }
 function _calculateTotal(items) { /* ... */ }
 ```
 
-### Classes and Services
+### Classes and services
 ```javascript
 // Classes: PascalCase
 class UserService {
@@ -332,7 +332,7 @@ function createHTTPClient(config) { /* ... */ }
 function createAnimationController() { /* ... */ }
 ```
 
-### Events and Constants
+### Events and constants
 ```javascript
 // Event names: namespace:action format
 const Events = {
@@ -350,9 +350,9 @@ const ErrorCodes = {
 }
 ```
 
-## Import/Export Patterns
+## Import/Export patterns
 
-### Named Exports (Preferred)
+### Named exports (Preferred)
 ```javascript
 // lib/api/userApi.js
 exports.getUser = async function(id) { /* ... */ }
@@ -363,7 +363,7 @@ exports.deleteUser = async function(id) { /* ... */ }
 const { getUser, updateUser } = require('api/userApi')
 ```
 
-### Default Export (For Classes/Singletons)
+### Default export (For Classes/Singletons)
 ```javascript
 // lib/services/logger.js
 class Logger {
@@ -378,7 +378,7 @@ module.exports = new Logger()
 const logger = require('services/logger')
 ```
 
-### Mixed Exports
+### Mixed exports
 ```javascript
 // lib/services/eventBus.js
 const _ = require('alloy/underscore')._
@@ -411,7 +411,7 @@ exports.orderApi = require('./orderApi').orderApi
 const { userApi, productApi } = require('api')
 ```
 
-### CommonJS Compatibility
+### CommonJS compatibility
 ```javascript
 // When using native modules that use require()
 const SomeNativeModule = require('ti.somemodule')
@@ -424,7 +424,7 @@ exports.nativeService = {
 }
 ```
 
-## Async/Promise Patterns
+## Async/Promise patterns
 
 ### Async/Await (Preferred)
 ```javascript
@@ -454,7 +454,7 @@ async function loadData() {
 }
 ```
 
-### Parallel Requests
+### Parallel requests
 ```javascript
 // When requests are independent - run in parallel
 async function loadDashboard() {
@@ -468,7 +468,7 @@ async function loadDashboard() {
 }
 ```
 
-### Sequential with Dependencies
+### Sequential with dependencies
 ```javascript
 // When each request depends on the previous
 async function processOrder(cartId) {
@@ -485,7 +485,7 @@ async function processOrder(cartId) {
 }
 ```
 
-### Error Handling with Specific Catches
+### Error handling with specific catches
 ```javascript
 async function login(email, password) {
   try {
@@ -508,7 +508,7 @@ async function login(email, password) {
 }
 ```
 
-### Converting Callbacks to Promises
+### Converting callbacks to promises
 ```javascript
 // Wrap Ti.Network.createHTTPClient in Promise
 function httpGet(url) {
@@ -544,7 +544,7 @@ function takePhoto() {
 }
 ```
 
-### Debouncing Async Operations
+### Debouncing async operations
 ```javascript
 // Useful for search, auto-save, etc.
 let searchTimeout = null
@@ -575,7 +575,7 @@ function cleanup() {
 }
 ```
 
-### Retry Pattern
+### Retry pattern
 ```javascript
 async function fetchWithRetry(fn, maxRetries = 3) {
   let lastError

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

@@ -1,8 +1,8 @@
-# Layer Contracts & Interfaces
+# Layer contracts & interfaces
 
 Contracts define the input/output specifications between layers, ensuring consistent communication and easy testing.
 
-## API Layer Contracts
+## API layer contracts
 
 ```javascript
 // lib/api/userApi.js
@@ -73,7 +73,7 @@ exports.userApi = {
 }
 ```
 
-## Service Layer Contracts
+## Service layer contracts
 
 ```javascript
 // lib/services/authService.js
@@ -123,7 +123,7 @@ exports.AuthService = {
 }
 ```
 
-## Controller Contracts
+## Controller contracts
 
 Document expected inputs and outputs for each controller:
 
@@ -167,7 +167,7 @@ function init() {
 $.cleanup = cleanup
 ```
 
-## Navigation Service Contract
+## Navigation service contract
 
 ```javascript
 // lib/services/navigation.js
@@ -210,7 +210,7 @@ exports.Navigation = {
 }
 ```
 
-## Helper Contracts
+## Helper contracts
 
 ```javascript
 // lib/helpers/formatters.js
@@ -242,7 +242,7 @@ exports.Formatters = {
 }
 ```
 
-## Event Bus Contract
+## Event bus contract
 
 ```javascript
 // lib/services/eventBus.js
@@ -271,7 +271,7 @@ exports.Events = {
 }
 ```
 
-## Contract Enforcement Tips
+## Contract enforcement tips
 
 1. **Always validate `$.args`** at controller initialization
 2. **Use TypeScript JSDoc** for IDE autocompletion and error detection

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

@@ -1,15 +1,15 @@
-# Alloy Controller Patterns
+# Alloy controller patterns
 
-## Titanium Layout Rules
+## Titanium layout rules
 
 - Use `layout: 'horizontal'` for left-to-right
 - Use `layout: 'vertical'` for top-to-bottom
-- Omit `layout` for composite (absolute positioning — the default)
+- Omit `layout` for composite (absolute positioning, the default)
 - Use margins on children instead of padding on parent
 
 > For a complete View + TSS + Controller example, see the Quick Start in SKILL.md.
 
-## Animation Usage
+## Animation usage
 
 Use `Ti.UI.createAnimation()` for UI transitions.
 
@@ -36,7 +36,7 @@ function hide(callback) {
 }
 ```
 
-## Dynamic Styling
+## Dynamic styling
 
 To change styles dynamically, use `applyProperties()` to batch updates.
 
@@ -49,7 +49,7 @@ function setStatus(isActive) {
 }
 ```
 
-## Percentage-Based Layouts
+## Percentage-based layouts
 
 Use percentage widths in TSS for responsive column layouts.
 
@@ -66,7 +66,7 @@ Use percentage widths in TSS for responsive column layouts.
 "#colRight": { height: 80, width: '33.33%', backgroundColor: '#dbeafe' }
 ```
 
-## Controller Lifecycle Patterns
+## Controller lifecycle patterns
 
 Show init, focus, blur, close lifecycle:
 ```javascript
@@ -102,7 +102,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Form Handling Patterns
+## Form handling patterns
 
 ```xml
 <!-- views/user/edit.xml -->
@@ -206,7 +206,7 @@ function setLoading(isLoading) {
 }
 ```
 
-## Loading State Patterns
+## Loading state patterns
 
 ```xml
 <!-- Skeleton loading pattern -->
@@ -261,7 +261,7 @@ async function loadData() {
 }
 ```
 
-## Modal and Dialog Patterns
+## Modal and dialog patterns
 
 ```javascript
 // AlertDialog
@@ -325,7 +325,7 @@ function openModal(route, params) {
 }
 ```
 
-## TabGroup Pattern
+## Tabgroup pattern
 
 ```xml
 <!-- views/main.xml -->
@@ -366,7 +366,7 @@ function updateNotificationBadge(count) {
 }
 ```
 
-## NavigationWindow Pattern (iOS)
+## Navigationwindow pattern (iOS)
 
 ```xml
 <!-- views/index.xml -->
@@ -403,7 +403,7 @@ function closeWindow(window, animated = true) {
 }
 ```
 
-## SearchBar with ListView
+## Searchbar with ListView
 
 ```xml
 <!-- views/contacts/list.xml -->
@@ -501,7 +501,7 @@ function cleanup() {
 $.cleanup = cleanup
 ```
 
-## Pull-to-Refresh Pattern
+## Pull-to-refresh pattern
 
 ```xml
 <ListView id="listView">