@maccesar/titools 2.0.0

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

@@ -0,0 +1,183 @@
+# Titanium Resources
+
+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)
+4. [Social Media](#social-media)
+5. [Learning Resources](#learning-resources)
+
+---
+
+## Developer Support
+
+### Official Channels
+
+- **[GitHub Discussions](https://github.com/tidev/titanium-sdk/discussions)** - Post questions and get help from the community
+- **[Slack](https://tidev.slack.com/)** - Titanium SDK Community Slack (help, jobs, announcements)
+  - Join at: https://tidev.slack.com/
+  - Channels for help, modules, announcements, and more
+
+### Module Resources
+
+- **[Module Search](https://modules.titaniumsdk.com/)** - Search for Titanium modules
+- **[Ti.Utils](https://github.com/TimanMax/Ti.Utils)** - Collection of utilities
+- **[From Zero to App](https://fromzerotoapp.com/)** - Tutorials and modules
+
+### Documentation
+
+- **[Titanium SDK Docs](https://titaniumsdk.com/)** - Official API documentation
+- **[Alloy Framework Docs](https://titaniumsdk.com/guide/Alloy_Framework/)** - Alloy MVC framework guide
+- **[This Skill (ti-guides)](../SKILL.md)** - Best practices and architecture
+
+---
+
+## Example Code
+
+### Official Repositories
+
+- **[tidev on GitHub](https://github.com/tidev)** - Titanium source code, modules, and sample apps
+  - **[titanium-mobile](https://github.com/tidev/titanium-mobile)** - Titanium SDK source
+  - **[titanium-cli](https://github.com/tidev/titanium-cli)** - Titanium CLI
+  - **[titanium-code-processor](https://github.com/tidev/titanium-code-processor)** - Code processor for Alloy
+
+### Sample Applications
+
+- **[Ti.Bluetooth](https://github.com/mwaylabs/ti.bluetooth)** - Bluetooth LE module
+- **[Ti.Map](https://github.com/tidev/ti.map)** - Native maps module
+- **[KitchenSink](https://github.com/tidev/KitchenSink)** - Comprehensive API examples
+
+### Community Projects
+
+Search GitHub for "titanium" to find thousands of open source modules and apps.
+
+---
+
+## Community Modules
+
+### Finding Modules
+
+1. **[Module Search](https://modules.titaniumsdk.com/)** - Official module registry
+2. **[npm](https://www.npmjs.com/search?q=titanium)** - NPM packages for Titanium
+3. **[GitHub](https://github.com/search?q=titanium+module)** - Search GitHub
+
+### Creating Modules
+
+See **`hyperloop-native-access.md`** for native module development:
+- Android modules (Java/Kotlin)
+- iOS modules (Objective-C/Swift)
+- Module packaging and distribution
+
+### Popular Modules
+
+- **ti.map** - Native maps (iOS & Android)
+- **ti.admob** - AdMob ads
+- **ti.imagefactory** - Image processing
+- **ti.facebook** - Facebook integration
+- **ti.media** - Extended media APIs
+
+---
+
+## Social Media
+
+### Official Accounts
+
+- **Bluesky:** [@titaniumsdk.com](https://bsky.app/profile/titaniumsdk.com) - SDK and CLI updates
+- **X (Twitter):**
+  - [@tidevio](https://x.com/tidevio) - Foundation account
+  - [@TitaniumSDK](https://x.com/TitaniumSDK) - SDK updates
+
+### Community
+
+- **[r/titanium](https://www.reddit.com/r/titanium/)** - Reddit community
+- **[Stack Overflow](https://stackoverflow.com/questions/tagged/titanium)** - Q&A
+
+---
+
+## Learning Resources
+
+### Getting Started
+
+1. **Hello World** - See `hello-world.md` in this skill
+2. **JavaScript Primer** - See `javascript-primer.md` in this skill
+3. **Alloy Framework** - See `alloy-guides` skill
+4. **Sample Apps** - Clone and study KitchenSink
+
+### Books and Guides
+
+- **Titanium Up & Running** - Build native apps with JavaScript
+- **Titanium Pocket Reference** - Quick API guide
+- **Alloy Guides** - Official Alloy framework documentation
+
+### Video Tutorials
+
+- **[From Zero to App](https://fromzerotoapp.com/)** - Video tutorials
+- **[YouTube](https://www.youtube.com/results?search_query=titanium+mobile)** - Community tutorials
+
+---
+
+## Tools and IDEs
+
+### IDE Support
+
+- **[VS Code](https://code.visualstudio.com/)** - With Titanium extensions
+
+### CLI Tools
+
+```bash
+# Create new project
+ti create
+
+# Build for iOS
+ti build -p ios
+
+# Build for Android
+ti build -p android
+
+# Run on device
+ti build -T device
+```
+
+See **`cli-reference.md`** for complete CLI documentation.
+
+---
+
+## Contributing
+
+### Report Bugs
+
+- **[GitHub Issues](https://github.com/tidev/titanium-sdk/issues)** - Bug reports
+- **[JIRA Archive](https://github.com/tidev/jira-archive)** - Legacy issue tracker (Appcelerator)
+
+### Contribute Code
+
+- **[Pull Request Guide](https://github.com/tidev/titanium-mobile/blob/master/CONTRIBUTING.md)** - Contributing guidelines
+- Follow coding standards (see **`style-and-conventions.md`**)
+
+---
+
+## Best Practices for Getting Help
+
+1. **Search first** - Check docs, GitHub issues, Stack Overflow
+2. **Be specific** - Include code, error messages, platform info
+3. **Provide minimal reproducible example** - Isolate the problem
+4. **Use Slack for quick questions** - GitHub Discussions for deeper discussions
+5. **Give back** - Help others when you can
+
+---
+
+## Resource Checklist
+
+For new Titanium developers:
+
+- [ ] Install Titanium SDK and CLI
+- [ ] Set up development environment (iOS/Android SDKs)
+- [ ] Read `hello-world.md`
+- [ ] Read `javascript-primer.md`
+- [ ] Complete a sample project
+- [ ] Join Slack community
+- [ ] Explore Alloy framework
+- [ ] Study sample apps on GitHub
+- [ ] Contribute back to community

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

@@ -0,0 +1,48 @@
+# Style and Conventions Reference
+
+## 1. Naming Conventions
+- **Variables**: `nounCategory` (e.g., `personName`, `buttonSubmit`).
+- **Functions**: `verbCategory` (e.g., `getPersonName`, `doSync`).
+- **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`).
+
+## 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).
+- **Operators**: Add a single space around operators.
+```javascript
+const fullName = firstName + ' ' + lastName
+```
+
+**CRITICAL: Return Statement Placement**
+Never put `return` on its own line followed by an object literal. JavaScript will insert a semicolon automatically, returning `undefined`.
+```javascript
+// ❌ WRONG
+return
+{
+  foo: 'bar'
+}
+
+// ✅ CORRECT
+return {
+  foo: 'bar'
+}
+```
+
+## 3. 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.
+- **JSDoc/Block comments**: Required for documenting functions and classes.
+```javascript
+/**
+ * @param {String} customerName Customer's full name.
+ */
+function getCustomer(customerName) {}
+```