@maccesar/titools 5.2.5 → 5.4.0

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

@@ -1,178 +1,210 @@
-# Titanium resources
+# IDE Integration
 
-Community resources, support channels, tools, and learning materials for Titanium developers.
 
-## Developer support
+You do not need a special editor to develop Titanium apps. A project is
+JavaScript, XML and TSS, and the Titanium CLI does the building, so any editor
+will do.
 
-### Official channels
+For an integrated experience, three editors have a Titanium package: it builds
+and runs your app on a simulator or device without leaving the window, generates
+Alloy files, and streams the build log. Visual Studio Code and the JetBrains
+plugin debug as well.
 
-- GitHub Discussions: https://github.com/tidev/titanium-sdk/discussions
-- Slack: https://tidev.slack.com/
-  - Join at: https://tidev.slack.com/
-  - Channels for help, modules, announcements, and more
+[Visual Studio Code](#visual-studio-code)
+[Pulsar](#pulsar)
+[JetBrains](#jetbrains-ides)
 
-### Module resources
+TiDev maintains the first two. The JetBrains plugin is a community project.
 
-- Module Search: https://modules.titaniumsdk.com/
-- From Zero to App: https://fromzerotoapp.com/
+All three drive the Titanium CLI you installed on the setup page for your
+machine, and inherit its requirements, including **Node.js 22.19.0 or 24.x**.
 
-### Documentation
+## Visual Studio Code
 
-- Titanium SDK Docs: https://titaniumsdk.com/
-- Alloy Framework Docs: https://titaniumsdk.com/docs/alloy
-- This skill (`ti-guides`): `../SKILL.md`
+The extension is **Titanium**, published by TiDev on the
+[Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=tidev.titanium-sdk).
 
----
+Install it from a terminal:
 
-## Example code
-
-### Official repositories
-
-- tidev on GitHub: https://github.com/tidev
-  - titanium-mobile: https://github.com/tidev/titanium-mobile
-  - titanium-cli: https://github.com/tidev/titanium-cli
-  - titanium-code-processor: https://github.com/tidev/titanium-code-processor
-
-### Sample applications
-
-- Ti.Map: https://github.com/tidev/ti.map
-- KitchenSink: https://github.com/tidev/KitchenSink
-
-### Community projects
-
-Search GitHub for "titanium" to find open source modules and apps.
-
----
-
-## Community modules
-
-### Finding modules
-
-1. Module Search: https://modules.titaniumsdk.com/
-2. npm: https://www.npmjs.com/search?q=titanium
-3. GitHub search: https://github.com/search?q=titanium+module
-
-### 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 and Android)
-- ti.admob: AdMob ads
-- ti.imagefactory: image processing
-- ti.facebook: Facebook integration
-- ti.media: extended media APIs
-
----
-
-## Social media
-
-### Official accounts
-
-- Bluesky: https://bsky.app/profile/titaniumsdk.com
-- X (Twitter):
-  - https://x.com/tidevio
-  - https://x.com/TitaniumSDK
-
-### Community
-
-- Reddit: https://www.reddit.com/r/titanium/
-- Stack Overflow: https://stackoverflow.com/questions/tagged/titanium
-
----
-
-## 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 the `alloy-guides` skill
-4. Sample apps: clone and study KitchenSink
+```sh
+code --install-extension tidev.titanium-sdk
+```
 
-### Books and guides
+Or open the Extensions view, search for `Titanium`, and pick the one published
+by TiDev.
 
-- Titanium Up & Running
-- Titanium Pocket Reference
-- Alloy Guides (official Alloy framework documentation)
+It needs Visual Studio Code 1.100.0 or newer.
 
-### Video tutorials
+The extension loads when the folder you open contains a `tiapp.xml`. Open a
+project directory rather than a parent folder holding several, or its commands
+will not appear in the Command Palette.
 
-- From Zero to App: https://fromzerotoapp.com/
-- YouTube results: https://www.youtube.com/results?search_query=titanium+mobile
+### What it adds
 
----
+A **Titanium view** in the Activity Bar lists the platforms you can build for
+and the targets under each: simulators, emulators, and connected devices. Build
+commands are available inline on a target and on its right-click menu.
 
-## Tools and IDEs
+![Visual Studio Code with the Titanium view open in the sidebar. Under Build App it lists iOS, with Device, Simulator, macOS, Ad Hoc, App Store and macOS App Store targets, and Android, with Device, Emulator and Play Store. The Emulator entry is expanded to show a Pixel 10, with run and debug buttons beside it. Below that are Recent builds and a Help And Feedback section. The editor on the right has the project's app.js open.](https://titaniumsdk.com/docs/guides/vscode-titanium-view.png)
 
-### IDE support
+`Titanium: Build` starts a build and `Titanium: Stop` ends one.
 
-Titanium has no IDE of its own; the CLI is the common denominator and every editor below drives it.
+| Command                             | macOS               | Windows and Linux    |
+| ----------------------------------- | ------------------- | -------------------- |
+| `Titanium: Build`                   | `cmd` `alt` `enter` | `ctrl` `alt` `enter` |
+| `Titanium: Stop`                    | `cmd` `alt` `.`     | `ctrl` `alt` `.`     |
+| `Titanium: Open related view`       | `cmd` `alt` `v`     | `ctrl` `alt` `v`     |
+| `Titanium: Open related style`      | `cmd` `alt` `s`     | `ctrl` `alt` `s`     |
+| `Titanium: Open related controller` | `cmd` `alt` `x`     | `ctrl` `alt` `x`     |
+| `Titanium: Open related files`      | `cmd` `alt` `a`     | `ctrl` `alt` `a`     |
 
-| Editor | Integration |
-|---|---|
-| Visual Studio Code | Titanium extension — https://code.visualstudio.com/ |
-| JetBrains IDEs | Community plugin — https://github.com/devloopsnet/titanium-jetbrains |
-| Atom | Titanium package (Atom itself is discontinued) |
+The three "open related" commands move between an Alloy controller, its view and
+its style without going through the file tree.
 
-### CLI tools
+`Titanium: Generate Alloy controller` and its siblings write models, views,
+styles, widgets and migrations where Alloy expects them.
+`Titanium: Create application`, `Titanium: Create module` and
+`Titanium: Create keystore` wrap the CLI's creation commands, and
+`Titanium: Fix environment issues` reports what your machine is missing.
 
-```bash
-# Create new project
-ti create
+The extension contributes a `titanium` debug type, so you can set breakpoints in
+your JavaScript and step through a running app rather than reading log output.
 
-# Build for iOS
-ti build -p ios
+### Settings worth knowing
 
-# Build for Android
-ti build -p android
+> [!IMPORTANT]
+> `titanium.general.displayBuildCommandInConsole` defaults to `true`, and the
+> command it writes to the output channel includes password arguments. Turn it
+> off before sharing your screen, recording a build, or pasting output into an
+> issue.
 
-# Run on device
-ti build -T device
+```json
+{
+  "titanium.general.displayBuildCommandInConsole": false,
+  "titanium.build.liveview": true,
+  "titanium.general.logLevel": "info",
+  "titanium.android.keystorePath": "/Users/you/keystores/myapp.keystore",
+  "titanium.android.keystoreAlias": "myapp"
+}
 ```
 
-See `cli-reference.md` for complete CLI documentation.
-
----
-
-## Contributing
+`titanium.build.liveview` is on by default and reloads the running app when you
+save. The two `keystore` settings save re-entering the path and alias on every
+Android package build; the password is asked for each time and is not stored
+here.
 
-### Report bugs
+## Pulsar
 
-- GitHub Issues: https://github.com/tidev/titanium-sdk/issues
-- JIRA Archive: https://github.com/tidev/jira-archive
+[Pulsar](https://pulsar-edit.dev/) is the community-maintained continuation of
+Atom, which GitHub retired in December 2022. The Titanium package for it is
+`titanium`, maintained at
+[tidev/pulsar-titanium](https://github.com/tidev/pulsar-titanium).
 
-### Contribute code
+Install it from Pulsar: **Preferences** or **Settings**, then **Install**, then
+search for `titanium`.
 
-- Pull Request Guide: https://github.com/tidev/titanium-mobile/blob/master/CONTRIBUTING.md
-- Follow coding standards in `style-and-conventions.md`
+Or from a terminal:
 
----
-
-## Best practices for getting help
+```sh
+pulsar --package install pulsar-titanium
+```
 
-1. Search first: check docs, GitHub issues, Stack Overflow.
-2. Be specific: include code, error messages, and platform info.
-3. Provide a minimal reproducible example.
-4. Use Slack for quick questions and GitHub Discussions for longer threads.
-5. Give back when you can.
+### What it adds
+
+A **toolbar** across the top of the editor, which is the main difference from
+the VS Code extension. It carries the build and run control, platform and target
+selectors, code signing and keystore configuration, a LiveView toggle, an info
+panel for the active project, the component generator, and the console toggle.
+
+| Command                   | Keymap               | What it does                          |
+| ------------------------- | -------------------- | ------------------------------------- |
+| `appc:build`              | `ctrl` `alt` `enter` | Build with the selected configuration |
+| `appc:stop`               | None                 | Stop the running build                |
+| `appc:console`            | None                 | Toggle the console                    |
+| `appc:generate`           | None                 | Generate an Alloy file or component   |
+| `appc:take-screenshot`    | None                 | Screenshot the running device         |
+| `appc:clean`              | `ctrl` `alt` `k`     | Clean the project directory           |
+| `appc:open view`          | `ctrl` `alt` `v`     | Open the related Alloy XML file       |
+| `appc:open style`         | `ctrl` `alt` `s`     | Open the related TSS file             |
+| `appc:open controller`    | `ctrl` `alt` `x`     | Open the related JavaScript file      |
+| `appc:open close related` | `ctrl` `alt` `a`     | Toggle all three related files        |
+
+> [!NOTE]
+> The `appc:` prefix is left over from Appcelerator and does not mean the
+> package needs the retired `appc` CLI. Enable **Use ti commands** in the
+> package settings so builds run through the Titanium CLI.
+
+The package also provides autocomplete and hyperclick, so Alloy identifiers
+resolve to the file that defines them.
+
+Like the VS Code extension, the console prints the command it is running by
+default. Those commands carry signing credentials on distribution builds, so
+turn it off in the package settings before sharing your screen.
+
+## JetBrains IDEs
+
+> [!NOTE]
+> This one is a community project, not TiDev's.
+> [devloopsnet/titanium-jetbrains](https://github.com/devloopsnet/titanium-jetbrains)
+> maintains it, Apache-2.0, and its Marketplace listing is from an unverified
+> vendor. It is young: first released in July 2026.
+
+The plugin is **Titanium** on the
+[JetBrains Marketplace](https://plugins.jetbrains.com/plugin/32945-titanium).
+Install it from your IDE: **Settings**, then **Plugins**, then **Marketplace**,
+and search for `Titanium`.
+
+It needs a 2024.3 or newer IntelliJ-Platform IDE, and it is a port of the VS
+Code extension, so most of what that does has an equivalent here.
+
+### What it adds
+
+Builds run as an IDE **run configuration** rather than a command, so the usual
+run and stop controls drive them and `tiapp.xml` is what marks a folder as a
+Titanium project. There is a build-explorer tool window, `ti create` wizards for
+apps and modules wired into **File, New, Project**, the Alloy generators, and
+SDK install and update management.
+
+Editor support goes further than the other two in one place: `.tss` gets real
+highlighting and completion rather than being mapped onto CSS, Alloy views get
+XML completion, and related controller, view and style files are reachable from
+gutter markers.
+
+> [!TIP]
+> It runs on every IntelliJ-Platform IDE, including the free Community editions
+> and Android Studio. JavaScript completion inside Alloy controllers is the one
+> part that needs the bundled JavaScript plugin, so it appears on WebStorm,
+> IDEA Ultimate, PhpStorm and PyCharm Professional and is absent elsewhere.
+> Everything else works either way.
+
+The debugger connects over the Chrome DevTools Protocol and handles breakpoints,
+stepping and local variables. It is **experimental**: expression evaluation and
+source-map fidelity are not finished, and iOS additionally needs
+`ios-webkit-debug-proxy`.
+
+One thing it does better than the VS Code extension: it echoes the build command
+to the console with **passwords masked**, so the warning above about
+`displayBuildCommandInConsole` has no equivalent here.
+
+## Other editors
+
+There is no Titanium package for any other editor, and the Atom package is not
+an option: Atom itself is gone, and Pulsar is where that work continued.
+
+JavaScript works everywhere and Alloy views are XML. The one gap is TSS. If
+your editor lets you map an extension to a language, point `.tss` at CSS and
+styles will highlight sensibly.
+
+Build from a terminal:
+
+```sh
+ti build --platform android
+```
 
----
+## Next
 
-## Resource checklist
+[Your first app](https://titaniumsdk.com/docs/build/first-app) creates a project and builds it.
 
-For new Titanium developers:
+## Current official documentation source
 
-- [ ] 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
+Guides are maintained in [tidev/titaniumsdk.com](https://github.com/tidev/titaniumsdk.com). Use [llms.txt](https://titaniumsdk.com/llms.txt) for discovery, append `.md` to guide routes for readable Markdown, and pin API routes to the project's SDK release. The old `tidev/titanium-docs` repository is an archive and is outside this skill's current-only content scope.

package/skills/ti-guides/references/sdk-release-notes.md

@@ -1,86 +1,43 @@
-# SDK release notes: what changes your code
+# SDK 13.4.1 release notes
 
-Condensed 13.x release history, filtered down to what actually affects how you write or configure an app. Full changelogs (every commit, every credit) live upstream under `Titanium_SDK_Release_Notes/`.
+Released baseline: SDK 13.4.1.GA. These are the current official registry notes. Use [compatibility](compatibility-matrix.md) for toolchain requirements; unreleased SDK 14 guidance is deferred.
 
-Each GA release desupports the previous patch release. Running an unsupported version is allowed, but bug reports against it are not accepted.
 
-<!-- TOC-START -->
-## Contents
+## About this release
 
-- [1. Version timeline](#1-version-timeline)
-- [2. 13.4.1 — patch](#2-1341--patch)
-- [3. 13.4.0 — Android target SDK 36 groundwork](#3-1340--android-target-sdk-36-groundwork)
-- [4. 13.3.1 — patch](#4-1331--patch)
-- [5. 13.3.0 — Xcode 27, iOS 27, multi-scene](#5-1330--xcode-27-ios-27-multi-scene)
-- [6. 13.2.0 — ViewPager2, keepHardwareMode](#6-1320--viewpager2-keephardwaremode)
-- [7. Bundled module versions](#7-bundled-module-versions)
+Titanium SDK 13.4.1 is a patch release of the SDK, addressing high-priority issues from previous releases, including keyboard issues in BottomNavigation on Android and a possible deadlock when opening windows on iOS.
 
-<!-- TOC-END -->
+As of this GA release, the previous Titanium SDK patch release (13.4.0) is no longer supported.
 
-## 1. Version timeline
+## Community Credits
 
-| Version | Date | Headline |
-|---|---|---|
-| 13.4.1.GA | 25 August 2026 | Patch — BottomNavigation keyboard and androidback (Android), window-open deadlock (iOS) |
-| 13.4.0.GA | 28 July 2026 | Prepares the SDK for Android target SDK 36; v8 memory cleanup |
-| 13.3.1.GA | 20 July 2026 | Patch — iOS restart and LiveView fixes |
-| 13.3.0.GA | 01 July 2026 | Xcode 27 and iOS 27, Hyperloop 8.0.0, iOS multi-scene apps |
-| 13.2.0.GA | 08 April 2026 | iOS core changes, Node.js 24 support, Android fixes |
-| 13.1.0.GA | — | Minor release, high-priority fixes |
-| 13.0.0.GA | — | Major release: iOS 26 / Xcode 26, Android 16 KB page size |
+* Michael Gangolf
+  * keyboard issues in BottomNavigation and `androidback` issue ([ef44640](https://github.com/tidev/titanium-sdk/commit/ef44640f9501807decc70377d1b8ff246d9fa554))
 
-## 2. 13.4.1 — patch
+* Hans Knöchel
+  * fix possible deadlock when opening window ([2957c43](https://github.com/tidev/titanium-sdk/commit/2957c4361b67709fb5131811c87e4c7c17429869))
+  * bump version ([98531c3](https://github.com/tidev/titanium-sdk/commit/98531c3962aa7b0b0b31db21821dba0acb7a5f03))
 
-Released 25 August 2026. Two fixes, both to crashes and input handling rather than to any API:
+## Bug Fixes
 
-- **Android:** keyboard issues in `BottomNavigation`, and the `androidback` event.
-- **iOS:** a possible deadlock when opening a window.
+### Android platform
 
-Desupports 13.4.0. No API surface changed, so code written against 13.4.0 needs no edit.
+* keyboard issues in BottomNavigation and `androidback` issue ([ef44640](https://github.com/tidev/titanium-sdk/commit/ef44640f9501807decc70377d1b8ff246d9fa554))
 
-## 3. 13.4.0 — Android target SDK 36 groundwork
+### iOS platform
 
-- **Prepares the SDK for Android target SDK 36.** Groundwork only; the compatibility matrix still lists API 35 as the maximum target. See [compatibility-matrix.md](compatibility-matrix.md) § Android.
-- v8 memory cleanup (Android).
-- `Window.rect` now reflects pre-open `left`/`top` instead of reporting zeros before the window opens (Android).
-- Build paths adjusted for Windows hosts.
-- iOS: fixed the dimming area in a TableView SearchBar.
-- The debug-only selector for `Ti.App._restart()` was removed, making the method callable outside debug builds.
+* fix possible deadlock when opening window ([2957c43](https://github.com/tidev/titanium-sdk/commit/2957c4361b67709fb5131811c87e4c7c17429869))
 
-## 4. 13.3.1 — patch
+## SDK Module Versions
 
-iOS-only fixes: the `restart` method, and LiveView restart. Hyperloop bumped to 8.0.1.
-
-## 5. 13.3.0 — Xcode 27, iOS 27, multi-scene
-
-- **Xcode 27 and iOS 27 support.** This postdates the Xcode/iOS rows in the compatibility matrix, which still cap at Xcode 16.x.
-- **iOS multi-scene applications** are supported.
-- **Hyperloop 8.0.0.**
-- ScrollableView (Android): a deprecation note was added for its older events. As of SDK 13.4.0 no ScrollableView event is actually flagged deprecated in the API metadata — `scroll`, `scrollend` and `dragend` all remain current — so treat this as advance warning, not as a removal.
-- ImageView: pinch-and-zoom improved on Android; the remote-image fade-in animation was removed on iOS.
-- TabGroup (iOS): `focus` is now emitted separately from `selected`. Code that assumed one event covered both cases needs checking.
-- `borderWidth` no longer renders at double thickness when `borderRadius` is an array (iOS).
-- Android: Material 3 BottomNavigation theme and dark/light switching fixes, CameraX rotation fix under orientation lock, WebView fix for URLs carrying large GET data, `Ti.Preferences` optimized.
-
-## 6. 13.2.0 — ViewPager2, keepHardwareMode
-
-- **ScrollableView moved to ViewPager2 on Android.** A backing-widget swap; verify paging, nested scrolling and any custom paging control against it.
-- **`keepHardwareMode` added to `Ti.UI.View`** (Android) — controls the view's render mode.
-- **`hideKeyboardAccessoryView` added to WebView** (iOS) to hide the keyboard accessory bar.
-- **AttributedString support on Android**, previously iOS-only.
-- Images can be dragged horizontally inside a ScrollableView (Android).
-- ListView caches `searchText` (Android).
-- The app name in `AndroidManifest.xml` now uses the i18n value.
-- Node.js 24 support; core-js upgraded, removing the `baseline-browser-mapping` warning.
-- iOS: Mac Catalyst fixes for `Ti.UI.Button` styling and events, and module builds with `mac=true`.
-
-## 7. Bundled module versions
-
-Versions shipped with each SDK. Unchanged rows are omitted.
-
-| Module | 13.2.0 (Android / iOS) | 13.3.0+ (Android / iOS) |
-|---|---|---|
-| facebook | 14.0.0 / 15.0.0 | 15.0.0 / 16.0.0 |
-| hyperloop | 7.1.0 / 7.1.0 | 8.0.1 / 8.0.1 (8.0.0 in 13.3.0) |
-
-Stable across 13.2.0–13.4.1: `ti.map` 5.7.0 / 7.3.1, `ti.webdialog` 2.5.0 / 3.0.2, `ti.playservices` 18.6.0 (Android only), `ti.identity` 3.2.0 / 5.0.0, `urlSession` 4.0.1 (iOS only), `ti.coremotion` 4.0.1 (iOS only), `ti.applesignin` 3.1.2 (iOS only).
+| Module      | Android version | iOS Version |
+| ----------- | --------------- | ----------- |
+| facebook | 15.0.0 | 16.0.0 |
+| ti.map | 5.7.0 | 7.3.1 |
+| ti.webdialog | 2.5.0 | 3.0.2 |
+| ti.playservices | 18.6.0 | n/a |
+| ti.identity | 3.2.0 | 5.0.0 |
+| urlSession | n/a | 4.0.1 |
+| ti.coremotion | n/a | 4.0.1 |
+| ti.applesignin | n/a | 3.1.2 |
+| hyperloop | 8.0.1 | 8.0.1 |