@maccesar/titools 2.0.6 → 2.2.0

package/skills/ti-guides/references/javascript-primer.md

@@ -2,7 +2,6 @@
 
 Essential JavaScript concepts, resources, and best practices for Titanium development.
 
-## Table of Contents
 1. [JavaScript Overview](#javascript-overview)
 2. [Learning Resources](#learning-resources)
 3. [Best Practices](#best-practices)
@@ -45,7 +44,7 @@ JavaScript is the language of Titanium. It's a powerful, lightweight, dynamic ob
 - **[MDN JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide)** - Comprehensive JavaScript documentation
 - **[Douglas Crockford's Resources](http://javascript.crockford.com/)** - From the creator of JSON and JSLint
 - **[JavaScript in 10 Minutes](https://github.com/spencertipping/js-in-ten-minutes)** - Dense advanced guide
-- **[Google JavaScript Style Guide](http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml)** - Code style guidelines
+- **[Google JavaScript Style Guide](https://google.github.io/styleguide/jsguide.html)** - Code style guidelines
 - **[Learning Advanced JavaScript](http://ejohn.org/apps/learn/)** - By John Resig (jQuery creator)
 
 ### Print Books (Recommended)
@@ -137,6 +136,8 @@ for (let i = 0, j = names.length; i < j; i++) {
 }
 ```
 
+This is especially important when working with Titanium proxy objects (representing native OS structures), where checking length on each iteration has additional overhead.
+
 **Even better:** ES6 `for...of`
 ```javascript
 for (const name of names) {
@@ -161,7 +162,7 @@ const z = 30;       // Cannot be reassigned
 
 ### Ternary Operator
 
-Compact conditional assignment:
+Compact conditional assignment. Value after `?` is assigned if the condition is true; value after `:` if false.
 
 ```javascript
 // Instead of this:

package/skills/ti-guides/references/resources.md

@@ -2,7 +2,6 @@
 
 Community resources, support channels, tools, and learning materials for Titanium developers.
 
-## Table of Contents
 1. [Developer Support](#developer-support)
 2. [Example Code](#example-code)
 3. [Community Modules](#community-modules)

package/skills/ti-guides/references/style-and-conventions.md

@@ -6,10 +6,38 @@
 - **Classes/Constructors**: `PascalCase` (e.g., `User`, `NetClient`).
 - **Factories**: Prefix with `create` (e.g., `createWidget`).
 - **Namespaces**: Use capitalized words (e.g., `App.UI.Widget`, `App.Network.Request`). Avoid lowercase for major namespaces (e.g., use `App.UI` instead of `app.ui`).
+- **Hungarian Notation**: Titanium SDK does not support the use of Hungarian Notation.
 
-## 2. Formatting
-- **Semicolons**: Mandatory in official SDK guides, but **omitted** in the `alloy-expert` standard (let ASI handle it).
-- **Indentation**: Consistency is most important (K&R/1TBS style).
+## 2. Language Rules
+- **Semicolons**: Always use semicolons to terminate statements. This is mandatory in official SDK guides, but **omitted** in the `ti-expert` standard (let ASI handle it).
+- **`this` keyword**: Use `this` with extreme care, as it sometimes doesn't refer to the object you expect.
+
+## 3. Formatting
+- **Indentation**: Both K&R/1TBS and Allman styles are acceptable. Consistency is most important — never mix styles in the same project.
+```javascript
+// K&R/1TBS Style
+if (x < 10) {
+  if (y > 10) {
+    // do this
+  }
+} else {
+  // do this
+}
+```
+```javascript
+// Allman Style
+if (x < 10)
+{
+  if (y > 10)
+  {
+    // do this
+  }
+}
+else
+{
+  // do this
+}
+```
 - **Operators**: Add a single space around operators.
 ```javascript
 const fullName = firstName + ' ' + lastName
@@ -30,19 +58,39 @@ return {
 }
 ```
 
-## 3. Primitive Types
+## 4. Control Statements
+- Switch statements should have a single space before the opening parenthesis and a single space after the closing parenthesis. Switch content is indented with one tab; content in each case is indented one tab as well.
+```javascript
+switch (someTest) {
+    case 1:
+        break;
+
+    case 2:
+        break;
+
+    default:
+        break;
+}
+```
+
+## 5. Primitive Types
 - Avoid using primitive type object constructors (e.g., `new String()`).
 - Use template literals or single space concatenation.
 
-## 4. Control Statements
-- Switch statements should have a single space around parentheses and proper indentation for cases.
-
-## 5. Comments and Documentation
-- **Single-line comments**: Preferred for short explanations.
+## 6. Comments and Documentation
+- **Single-line comments**: Required to reduce programmer error. Inline statement comments should be used at a minimum or not at all.
 - **JSDoc/Block comments**: Required for documenting functions and classes.
 ```javascript
+// Calculate position using initial
+// and offset x coordinates.
+const finalPos = initPosX + offsetPosX;
+
 /**
  * @param {String} customerName Customer's full name.
  */
 function getCustomer(customerName) {}
 ```
+
+## 7. References
+- Douglas Crockford's JavaScript Code Conventions
+- Google's JavaScript Style Guide (https://google.github.io/styleguide/jsguide.html)

package/skills/ti-guides/references/tiapp-config.md

@@ -19,14 +19,14 @@ Complete reference for Titanium app configuration files. `tiapp.xml` is the main
       <dict>
         <key>UISupportedInterfaceOrientations~iphone</key>
         <array>
-          <string>Ti.UI.PORTRAIT</string>
+          <string>UIInterfaceOrientationPortrait</string>
         </array>
         <key>UISupportedInterfaceOrientations~ipad</key>
         <array>
-          <string>Ti.UI.PORTRAIT</string>
-          <string>Ti.UI.UPSIDE_PORTRAIT</string>
-          <string>Ti.UI.LANDSCAPE_LEFT</string>
-          <string>Ti.UI.LANDSCAPE_RIGHT</string>
+          <string>UIInterfaceOrientationPortrait</string>
+          <string>UIInterfaceOrientationPortraitUpsideDown</string>
+          <string>UIInterfaceOrientationLandscapeLeft</string>
+          <string>UIInterfaceOrientationLandscapeRight</string>
         </array>
       </dict>
     </plist>
@@ -71,6 +71,13 @@ Complete reference for Titanium app configuration files. `tiapp.xml` is the main
 
 ### Optional Elements
 
+#### `<defaultLang>`
+Sets the default language for Android i18n `strings.xml`. Android defaults to `en`. If you only use a single non-English i18n file, set this to that language.
+
+```xml
+<defaultLang>de</defaultLang>
+```
+
 #### `<copyright>`
 Application copyright.
 
@@ -202,6 +209,20 @@ Default unit for sizes/positions.
 
 **Values:** `system`, `cm`, `dip`/`dp`, `in`, `mm`, `px`
 
+#### `run-on-main-thread`
+**Since 5.1.0.** Run all JavaScript on the main thread instead of a secondary thread. Disabled by default in existing projects, enabled in new projects. Enabled automatically in SDK 7.0.0+.
+
+```xml
+<property name="run-on-main-thread" type="bool">true</property>
+```
+
+#### `allow-custom-keyboards`
+**Since 6.1.0.** Allow or disallow custom iOS 8+ keyboard extensions. Custom keyboards are allowed by default. Set to `false` to disallow them.
+
+```xml
+<property name="allow-custom-keyboards" type="bool">false</property>
+```
+
 #### `appc-sourcecode-encryption-policy`
 Encryption policy for app assets.
 
@@ -467,6 +488,10 @@ Settings for generated `Info.plist`. Uses key/value pairs.
     <string>audio</string>
     <string>location</string>
     <string>voip</string>
+    <string>newsstand-content</string>
+    <string>external-accessory</string>
+    <string>bluetooth-central</string>
+    <string>bluetooth-peripheral</string>
   </array>
 </dict>
 </plist>
@@ -480,8 +505,25 @@ Settings for generated `Info.plist`. Uses key/value pairs.
   <array>
     <string>telephony</string>
     <string>wifi</string>
-    <string>gps</string>
+    <string>sms</string>
+    <string>still-camera</string>
+    <string>auto-focus-camera</string>
+    <string>front-facing-camera</string>
+    <string>camera-flash</string>
+    <string>video-camera</string>
     <string>accelerometer</string>
+    <string>gyroscope</string>
+    <string>location-services</string>
+    <string>gps</string>
+    <string>magnetometer</string>
+    <string>gamekit</string>
+    <string>microphone</string>
+    <string>opengles-1</string>
+    <string>opengles-2</string>
+    <string>armv6</string>
+    <string>armv7</string>
+    <string>peer-peer</string>
+    <string>bluetooth-le</string>
   </array>
 </dict>
 </plist>

package/skills/ti-howtos/SKILL.md

@@ -28,31 +28,6 @@ This skill automatically detects Titanium projects when invoked and provides nat
 - **Not detected** → Indicates this is for Titanium projects only
 :::
 
-## Table of Contents
-
-- [Titanium SDK How-tos Expert](#titanium-sdk-how-tos-expert)
-  - [Project Detection](#project-detection)
-  - [Table of Contents](#table-of-contents)
-  - [Integration Workflow](#integration-workflow)
-  - [Native Integration Rules (Low Freedom)](#native-integration-rules-low-freedom)
-    - [iOS Permissions](#ios-permissions)
-    - [Android Resource Management](#android-resource-management)
-    - [Data \& Networking](#data--networking)
-    - [Media \& Memory](#media--memory)
-    - [Platform-Specific Properties](#platform-specific-properties)
-  - [Reference Guides (Progressive Disclosure)](#reference-guides-progressive-disclosure)
-    - [Core Features](#core-features)
-    - [Data Handling](#data-handling)
-    - [Media \& Content](#media--content)
-    - [Web Integration](#web-integration)
-    - [Platform-Specific (Android)](#platform-specific-android)
-    - [Platform-Specific (iOS)](#platform-specific-ios)
-    - [Advanced \& DevOps](#advanced--devops)
-  - [Related Skills](#related-skills)
-  - [Response Format](#response-format)
-
----
-
 ## Integration Workflow
 
 1.  **Requirement Check**: Identify needed permissions, `tiapp.xml` configurations, and module dependencies.
@@ -121,7 +96,7 @@ if (OS_IOS) {
 - iOS: `statusBarStyle`, `modalStyle`, `modalTransitionStyle`, any `Ti.UI.iOS.*`
 - Android: `actionBar` config, any `Ti.UI.Android.*` constant
 
-**For platform-specific modifier syntax, see** [Platform Modifiers (purgetss)](skills/purgetss/references/platform-modifiers.md) or [Platform UI guides](references/ios-platform-deep-dives.md).
+**For platform-specific modifier syntax in TSS, see** [Code Conventions (ti-expert)](skills/ti-expert/references/code-conventions.md#platform--device-modifiers) or [Platform UI guides](references/ios-platform-deep-dives.md).
 :::
 
 ## Reference Guides (Progressive Disclosure)
@@ -161,7 +136,7 @@ For tasks beyond native feature integration, use these complementary skills:
 
 | Task                                           | Use This Skill |
 | ---------------------------------------------- | -------------- |
-| Project architecture, services, memory cleanup | `alloy-expert` |
+| Project architecture, services, memory cleanup | `ti-expert`    |
 | UI layouts, ListViews, gestures, animations    | `ti-ui`        |
 | Hyperloop, app distribution, tiapp.xml config  | `ti-guides`    |
 | Alloy MVC, models, data binding                | `alloy-guides` |

package/skills/ti-howtos/references/android-platform-deep-dives.md

@@ -1,63 +1,5 @@
 # Android Platform Deep Dives
 
-## Table of Contents
-
-- [Android Platform Deep Dives](#android-platform-deep-dives)
-  - [Table of Contents](#table-of-contents)
-  - [1. Android Intent Filters (Advanced)](#1-android-intent-filters-advanced)
-    - [Critical Step: Copy Root Activity](#critical-step-copy-root-activity)
-    - [Retrieving Intent Data](#retrieving-intent-data)
-  - [2. Broadcast Intents with Permissions](#2-broadcast-intents-with-permissions)
-    - [Sending with Permission](#sending-with-permission)
-    - [Declaring Permission in tiapp.xml](#declaring-permission-in-tiappxml)
-  - [3. FusedLocationProvider (TiSDK 7.1.0+)](#3-fusedlocationprovider-tisdk-710)
-  - [4. Android Intents](#4-android-intents)
-    - [Overview](#overview)
-    - [Intent Structure](#intent-structure)
-    - [Creating Intents](#creating-intents)
-      - [Simple Intent (Action only)](#simple-intent-action-only)
-      - [Intent with Action and Data](#intent-with-action-and-data)
-      - [Intent with Extras](#intent-with-extras)
-    - [Common Use Cases](#common-use-cases)
-      - [Open URL in Browser](#open-url-in-browser)
-      - [Dial Phone Number](#dial-phone-number)
-      - [Send Email](#send-email)
-      - [Share Content](#share-content)
-      - [Open PDF File](#open-pdf-file)
-    - [Starting Other Apps](#starting-other-apps)
-  - [2. Intent Filters](#2-intent-filters)
-    - [Overview](#overview-1)
-    - [Configuring in tiapp.xml](#configuring-in-tiappxml)
-    - [Handling Incoming Intents](#handling-incoming-intents)
-      - [Get Intent Data on Startup](#get-intent-data-on-startup)
-      - [Listen for New Intents (Activity Restart)](#listen-for-new-intents-activity-restart)
-    - [Deep Linking Example](#deep-linking-example)
-  - [3. Broadcast Intents and Receivers](#3-broadcast-intents-and-receivers)
-    - [Overview](#overview-2)
-    - [System Broadcasts](#system-broadcasts)
-    - [Registering Broadcast Receivers](#registering-broadcast-receivers)
-      - [Dynamic Registration (in code)](#dynamic-registration-in-code)
-      - [Network Change Listener](#network-change-listener)
-    - [Sending Custom Broadcasts](#sending-custom-broadcasts)
-      - [Receiver for Custom Broadcast](#receiver-for-custom-broadcast)
-    - [Boot Receiver](#boot-receiver)
-  - [4. Android Services](#4-android-services)
-    - [Overview](#overview-3)
-    - [Service Types](#service-types)
-    - [Creating a Service](#creating-a-service)
-    - [IntentService](#intentservice)
-    - [Foreground Service](#foreground-service)
-    - [Service Lifecycle Management](#service-lifecycle-management)
-    - [Inter-Service Communication](#inter-service-communication)
-  - [5. Android Permissions](#5-android-permissions)
-    - [Runtime Permissions (Android 6.0+)](#runtime-permissions-android-60)
-    - [Common Dangerous Permissions](#common-dangerous-permissions)
-  - [Best Practices](#best-practices)
-    - [Common Dangerous Permissions](#common-dangerous-permissions-1)
-  - [Best Practices](#best-practices-1)
-
----
-
 ## 1. Android Intent Filters (Advanced)
 
 To allow your app to receive implicit intents (e.g., opening a PDF file or a web link), you must register the filter in the manifest.
@@ -165,8 +107,8 @@ const intent = Ti.Android.createIntent({
   action: 'com.example.MY_ACTION',
   type: 'text/plain'
 });
-intent.addExtra('message', 'Hello from Titanium');
-intent.addExtra('count', 42);
+intent.putExtra('message', 'Hello from Titanium');
+intent.putExtra('count', 42);
 ```
 
 ### Common Use Cases
@@ -195,8 +137,8 @@ const intent = Ti.Android.createIntent({
   action: Ti.Android.ACTION_SENDTO,
   data: 'mailto:user@example.com'
 });
-intent.addExtra(Ti.Android.EXTRA_SUBJECT, 'Hello');
-intent.addExtra(Ti.Android.EXTRA_TEXT, 'Email body');
+intent.putExtra(Ti.Android.EXTRA_SUBJECT, 'Hello');
+intent.putExtra(Ti.Android.EXTRA_TEXT, 'Email body');
 Ti.Android.currentActivity.startActivity(intent);
 ```
 
@@ -206,7 +148,7 @@ const intent = Ti.Android.createIntent({
   action: Ti.Android.ACTION_SEND,
   type: 'text/plain'
 });
-intent.addExtra(Ti.Android.EXTRA_TEXT, 'Check this out!');
+intent.putExtra(Ti.Android.EXTRA_TEXT, 'Check this out!');
 Ti.Android.currentActivity.startActivity(intent);
 ```
 
@@ -236,7 +178,37 @@ try {
 }
 ```
 
-## 2. Intent Filters
+### Intent Chooser
+Force the system to show an app chooser dialog (even if a default is set):
+```javascript
+const intent = Ti.Android.createIntent({
+    action: Ti.Android.ACTION_SEND,
+    type: 'text/plain'
+});
+intent.putExtra(Ti.Android.EXTRA_TEXT, 'Share this text');
+
+Ti.Android.currentActivity.startActivity(
+    Ti.Android.createIntentChooser(intent, 'Share via...')
+);
+```
+
+### Getting Results from Activities
+```javascript
+const intent = Ti.Android.createIntent({
+    action: 'android.media.action.IMAGE_CAPTURE'
+});
+
+Ti.Android.currentActivity.startActivityForResult(intent, (e) => {
+    if (e.resultCode === Ti.Android.RESULT_OK) {
+        const imageUri = e.intent.data;
+        Ti.API.info(`Captured image: ${imageUri}`);
+    } else if (e.resultCode === Ti.Android.RESULT_CANCELED) {
+        Ti.API.info('User canceled');
+    }
+});
+```
+
+## 5. Intent Filters
 
 ### Overview
 Intent Filters advertise your app's capability to handle certain actions and data types. Enable deep linking, file handling, and inter-app communication.
@@ -338,7 +310,7 @@ if (intent && intent.getData()) {
 }
 ```
 
-## 3. Broadcast Intents and Receivers
+## 6. Broadcast Intents and Receivers
 
 ### Overview
 Broadcast Intents allow system-wide or app-wide messaging. Apps can send broadcasts and register receivers to listen for them.
@@ -413,7 +385,7 @@ Ti.Android.registerBroadcastReceiver(networkReceiver, [
 const intent = Ti.Android.createIntent({
   action: 'com.myapp.CUSTOM_EVENT'
 });
-intent.addExtra('data', 'Custom data here');
+intent.putExtra('data', 'Custom data here');
 Ti.Android.currentActivity.sendBroadcast(intent);
 ```
 
@@ -452,7 +424,7 @@ Ti.Android.registerBroadcastReceiver(customReceiver, [
 </android>
 ```
 
-## 4. Android Services
+## 7. Android Services
 
 ### Overview
 Services are background components that run independently of the UI. Useful for long-running operations like music playback, location tracking, or network polling.
@@ -573,7 +545,7 @@ Ti.Android.currentActivity.addEventListener('destroy', () => {
 const intent = Ti.Android.createServiceIntent({
   url: 'myservice.js'
 });
-intent.addExtra('command', 'pause');
+intent.putExtra('command', 'pause');
 Ti.Android.startService(intent);
 
 // In service
@@ -583,7 +555,7 @@ if (command === 'pause') {
 }
 ```
 
-## 5. Android Permissions
+## 8. Android Permissions
 
 ### Runtime Permissions (Android 6.0+)
 
@@ -635,24 +607,3 @@ checkPermission();
 6. **Validate intent data** before processing
 7. **Use proper Intent Flags** for navigation behavior
 8. **Test intent filters** with ADB: `adb shell am start -W -a android.intent.action.VIEW -d "myapp://path"`
-
-### Common Dangerous Permissions
-- `ACCESS_FINE_LOCATION` - GPS location
-- `ACCESS_COARSE_LOCATION` - Network location
-- `CAMERA` - Camera access
-- `READ_EXTERNAL_STORAGE` - Read files
-- `WRITE_EXTERNAL_STORAGE` - Write files
-- `RECORD_AUDIO` - Microphone
-- `CALL_PHONE` - Make phone calls
-- `SEND_SMS` / `READ_SMS` - SMS access
-
-## Best Practices
-
-1. **Always unregister** broadcast receivers when no longer needed
-2. **Stop services** explicitly to conserve battery
-3. **Use IntentService** for one-off background tasks
-4. **Use foreground services** for user-visible long operations
-5. **Handle runtime permissions** gracefully on Android 6.0+
-6. **Validate intent data** before processing
-7. **Use proper Intent Flags** for navigation behavior
-8. **Test intent filters** with ADB: `adb shell am start -W -a android.intent.action.VIEW -d "myapp://path"`

package/skills/ti-howtos/references/automation-fastlane-appium.md

@@ -2,20 +2,6 @@
 
 Guide for setting up continuous integration pipelines, automatic testing, and deployment in Titanium.
 
-## Table of Contents
-
-- [Automation with Fastlane and Appium](#automation-with-fastlane-and-appium)
-  - [Table of Contents](#table-of-contents)
-  - [1. UI Testing with Appium](#1-ui-testing-with-appium)
-    - [Prerequisites](#prerequisites)
-    - [Test Example (Mocha + WebdriverIO)](#test-example-mocha--webdriverio)
-  - [2. Automation with Fastlane](#2-automation-with-fastlane)
-    - [Titanium Plugins](#titanium-plugins)
-    - [Fastfile Configuration](#fastfile-configuration)
-  - [3. CI/CD Best Practices](#3-cicd-best-practices)
-
----
-
 ## 1. UI Testing with Appium
 
 Appium allows for automated functional testing on real devices and simulators.
@@ -93,3 +79,18 @@ end
 2. **Environment Lanes**: Define separate lanes for `beta`, `production`, and `test`.
 3. **Profile Management**: Use Fastlane Match to sync certificates and provisioning profiles across the team.
 4. **Snapshots**: Use Fastlane's `snapshot` action to automate App Store screenshot generation.
+
+## 4. Unit Testing with TiUnit
+
+For unit tests (non-UI), consider **TiUnit**, a Jasmine-based testing framework for Titanium:
+- Runs tests inside the app context
+- Supports standard Jasmine `describe`/`it`/`expect` syntax
+- Can be integrated into CI pipelines
+
+## 5. Broader CI/CD Options
+
+Beyond Fastlane and Appium, Titanium apps can integrate with:
+- **Jenkins** — for build orchestration and pipeline management
+- **SonarQube** — for code quality analysis
+- **AWS Device Farm** — for testing on real devices in the cloud
+- **Nexus/Artifactory** — for build artifact archiving and versioning

package/skills/ti-howtos/references/buffer-codec-streams.md

@@ -2,25 +2,6 @@
 
 Guide for advanced binary data manipulation and data flows in Titanium SDK.
 
-## Table of Contents
-
-- [Buffer, Codec, and Streams](#buffer-codec-and-streams)
-  - [Table of Contents](#table-of-contents)
-  - [1. Titanium.Buffer](#1-titaniumbuffer)
-    - [Creating Buffers](#creating-buffers)
-    - [Common Operations](#common-operations)
-  - [2. Titanium.Codec](#2-titaniumcodec)
-    - [Encoding Numbers](#encoding-numbers)
-    - [Decoding Strings](#decoding-strings)
-  - [3. Streams](#3-streams)
-    - [Stream Types](#stream-types)
-    - [Example: BufferStream](#example-bufferstream)
-    - [Example: FileStream (Chunk-based reading)](#example-filestream-chunk-based-reading)
-    - [Example: BlobStream (Camera to File)](#example-blobstream-camera-to-file)
-  - [4. Best Practices](#4-best-practices)
-
----
-
 ## 1. Titanium.Buffer
 
 Buffers are mutable and resizable containers for bytes (byte arrays).
@@ -75,6 +56,23 @@ const text = Ti.Codec.decodeString({
 });
 ```
 
+### Supported Types and Charsets
+
+**Numeric types**: `TYPE_BYTE`, `TYPE_SHORT`, `TYPE_INT`, `TYPE_LONG`, `TYPE_FLOAT`, `TYPE_DOUBLE`
+
+**String charsets**: `CHARSET_UTF8`, `CHARSET_UTF16`, `CHARSET_UTF16BE`, `CHARSET_UTF16LE`, `CHARSET_ISO_LATIN1`
+
+### Position Parameter
+The `position` parameter controls where encoding/decoding starts in the buffer:
+```javascript
+Ti.Codec.encodeNumber({
+    source: 42,
+    dest: buffer,
+    position: 4,  // start writing at byte 4
+    type: Ti.Codec.TYPE_INT
+});
+```
+
 ## 3. Streams
 
 Streams allow reading and writing data in a serialized and memory-efficient way.
@@ -84,6 +82,8 @@ Streams allow reading and writing data in a serialized and memory-efficient way.
 2. **FileStream**: For file operations (more efficient than `file.read()`).
 3. **BlobStream**: Read-only for Blob objects (images, camera).
 
+**Stream modes**: `Ti.Filesystem.MODE_READ`, `Ti.Filesystem.MODE_WRITE`, `Ti.Filesystem.MODE_APPEND`
+
 ### Example: BufferStream
 ```javascript
 const buffer = Ti.createBuffer({ length: 1024 });
@@ -118,16 +118,16 @@ Ti.Media.showCamera({
             source: e.media,
             mode: Ti.Stream.MODE_READ
         });
-        
+
         const outfile = Ti.Filesystem.getFile(Ti.Filesystem.applicationDataDirectory, 'photo.jpg');
         const outstream = outfile.open(Ti.Filesystem.MODE_WRITE);
-        
+
         const buffer = Ti.createBuffer({ length: 4096 });
         let readBytes = 0;
         while ((readBytes = instream.read(buffer)) > 0) {
             outstream.write(buffer, 0, readBytes);
         }
-        
+
         instream.close();
         outstream.close();
     }