npm - @maccesar/titools - Versions diffs - 3.3.0 → 4.0.0 - Mend

@maccesar/titools 3.3.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (101) hide show

package/README.md +27 -61
package/lib/cleanup.js +29 -0
package/lib/commands/agents.js +8 -7
package/lib/commands/skills.js +118 -23
package/lib/config.js +13 -15
package/lib/installer.js +5 -3
package/lib/utils.js +36 -0
package/package.json +1 -1
package/skills/alloy-guides/SKILL.md +188 -0
package/skills/alloy-guides/references/CLI_TASKS.md +233 -0
package/skills/alloy-guides/references/CONCEPTS.md +171 -0
package/skills/alloy-guides/references/CONTROLLERS.md +279 -0
package/skills/alloy-guides/references/MODELS.md +742 -0
package/skills/alloy-guides/references/MODELS_ADVANCED.md +482 -0
package/skills/alloy-guides/references/PURGETSS.md +57 -0
package/skills/alloy-guides/references/VIEWS_DYNAMIC.md +235 -0
package/skills/alloy-guides/references/VIEWS_STYLES.md +375 -0
package/skills/alloy-guides/references/VIEWS_WITHOUT_CONTROLLERS.md +102 -0
package/skills/alloy-guides/references/VIEWS_XML.md +581 -0
package/skills/alloy-guides/references/WIDGETS.md +160 -0
package/skills/alloy-howtos/SKILL.md +179 -0
package/skills/alloy-howtos/references/best_practices.md +121 -0
package/skills/alloy-howtos/references/cli_reference.md +230 -0
package/skills/alloy-howtos/references/config_files.md +158 -0
package/skills/alloy-howtos/references/custom_tags.md +148 -0
package/skills/alloy-howtos/references/debugging_troubleshooting.md +78 -0
package/skills/alloy-howtos/references/samples.md +156 -0
package/skills/purgetss/SKILL.md +6 -3
package/skills/purgetss/references/EXAMPLES.md +8 -6
package/skills/purgetss/references/app-branding.md +5 -0
package/skills/purgetss/references/apply-directive.md +1 -1
package/skills/purgetss/references/class-categories.md +1 -1
package/skills/purgetss/references/class-index-properties.md +618 -0
package/skills/purgetss/references/class-index.md +4 -610
package/skills/purgetss/references/cli-commands.md +15 -0
package/skills/purgetss/references/custom-fonts.md +39 -36
package/skills/purgetss/references/custom-rules.md +1 -1
package/skills/purgetss/references/customization-deep-dive.md +64 -1
package/skills/purgetss/references/icon-fonts.md +2 -0
package/skills/purgetss/references/migration-guide.md +53 -1
package/skills/purgetss/references/multi-density-images.md +53 -2
package/skills/purgetss/references/svg-pipeline.md +249 -0
package/skills/purgetss/references/tikit-components.md +2 -2
package/skills/purgetss/references/titanium-resets.md +2 -2
package/skills/purgetss/references/ui-ux-design.md +7 -5
package/skills/purgetss/references/version-history.md +12 -0
package/skills/ti-api/SKILL.md +128 -0
package/skills/ti-api/references/api-android.md +675 -0
package/skills/ti-api/references/api-app-platform.md +636 -0
package/skills/ti-api/references/api-core.md +764 -0
package/skills/ti-api/references/api-data-network.md +641 -0
package/skills/ti-api/references/api-media.md +655 -0
package/skills/ti-api/references/api-modules-ble-bluetooth.md +657 -0
package/skills/ti-api/references/api-modules-coremotion-urlsession.md +411 -0
package/skills/ti-api/references/api-modules-map.md +632 -0
package/skills/ti-api/references/api-modules-nfc.md +725 -0
package/skills/ti-api/references/api-modules-social-misc.md +526 -0
package/skills/ti-api/references/api-services.md +700 -0
package/skills/ti-api/references/api-ui-android.md +499 -0
package/skills/ti-api/references/api-ui-extras.md +702 -0
package/skills/ti-api/references/api-ui-ios-animator.md +378 -0
package/skills/ti-api/references/api-ui-ios.md +756 -0
package/skills/ti-api/references/api-ui-lists.md +581 -0
package/skills/ti-api/references/api-ui-text-input.md +607 -0
package/skills/ti-api/references/api-ui-views.md +572 -0
package/skills/ti-api/references/api-ui-windows-navigation.md +676 -0
package/skills/ti-api/references/api-xml-global.md +743 -0
package/skills/ti-guides/SKILL.md +82 -0
package/skills/ti-guides/references/advanced-data-and-images.md +155 -0
package/skills/ti-guides/references/android-manifest.md +97 -0
package/skills/ti-guides/references/app-distribution.md +373 -0
package/skills/ti-guides/references/application-frameworks.md +366 -0
package/skills/ti-guides/references/cli-reference.md +700 -0
package/skills/ti-guides/references/coding-best-practices.md +150 -0
package/skills/ti-guides/references/commonjs-advanced.md +279 -0
package/skills/ti-guides/references/hello-world.md +99 -0
package/skills/ti-guides/references/hyperloop-native-access.md +458 -0
package/skills/ti-guides/references/javascript-primer.md +402 -0
package/skills/ti-guides/references/reserved-words.md +36 -0
package/skills/ti-guides/references/resources.md +172 -0
package/skills/ti-guides/references/style-and-conventions.md +104 -0
package/skills/ti-guides/references/tiapp-config.md +655 -0
package/skills/ti-howtos/SKILL.md +131 -0
package/skills/ti-howtos/references/android-platform-deep-dives.md +609 -0
package/skills/ti-howtos/references/automation-fastlane-appium.md +96 -0
package/skills/ti-howtos/references/buffer-codec-streams.md +162 -0
package/skills/ti-howtos/references/cross-platform-development.md +358 -0
package/skills/ti-howtos/references/debugging-profiling.md +473 -0
package/skills/ti-howtos/references/extending-titanium.md +684 -0
package/skills/ti-howtos/references/google-maps-v2.md +172 -0
package/skills/ti-howtos/references/ios-map-kit.md +149 -0
package/skills/ti-howtos/references/ios-platform-deep-dives.md +595 -0
package/skills/ti-howtos/references/local-data-sources.md +310 -0
package/skills/ti-howtos/references/location-and-maps.md +267 -0
package/skills/ti-howtos/references/media-apis.md +268 -0
package/skills/ti-howtos/references/notification-services.md +539 -0
package/skills/ti-howtos/references/remote-data-sources.md +339 -0
package/skills/ti-howtos/references/tutorials.md +552 -0
package/skills/ti-howtos/references/using-modules.md +182 -0
package/skills/ti-howtos/references/web-content-integration.md +288 -0
package/skills/ti-howtos/references/webpack-build-pipeline.md +125 -0

package/skills/ti-howtos/references/web-content-integration.md ADDED Viewed

@@ -0,0 +1,288 @@
+# Web content integration
+## 1. The WebView component
+### WKWebView (Titanium SDK 8.0.0+)
+As of Titanium SDK 8.0.0, WKWebView is the only supported web view on iOS. UIWebView was deprecated and removed. WKWebView behaves differently, so plan for that.
+### Basic WebView creation
+Remote URL:
+```javascript
+const webview = Ti.UI.createWebView({
+  url: 'https://titaniumsdk.com'
+});
+win.add(webview);
+win.open();
+```
+Local HTML:
+```javascript
+const webview = Ti.UI.createWebView({
+  url: 'local.html' // Relative to Resources or app/assets/app/lib
+});
+win.add(webview);
+```
+Inline HTML:
+```javascript
+const webview = Ti.UI.createWebView({
+  html: '<html><body><h1>Hello</h1></body></html>'
+});
+```
+### Local web content with assets
+Local content can include CSS, JS, and images. Paths are relative to Resources (Classic) or app/assets/app/lib (Alloy).
+`local.html`:
+```html
+<html>
+  <head>
+    <link rel="stylesheet" type="text/css" href="local.css"/>
+    <script src="local.js"></script>
+  </head>
+  <body>
+    <p>Local content</p>
+  </body>
+</html>
+```
+### WebView properties and methods
+Navigation:
+- `canGoBack()` - returns true if possible to go back
+- `canGoForward()` - returns true if possible to go forward
+- `goBack()` - navigate back in history
+- `goForward()` - navigate forward in history
+Load control:
+- `loading` (Boolean) - current loading state
+- `reload()` - refresh the page
+- `stopLoading()` - stop loading
+- `repaint()` - force repaint
+Data handling:
+- `url` - local or remote URL
+- `html` - inline HTML string
+- `scalesPageToFit` - scale content to dimensions
+- `setBasicAuthentication(host, username, password)` - HTTP auth
+```javascript
+webView.setBasicAuthentication('myDomain.com', 'username', 'password');
+```
+Events:
+- `beforeload` - fires before loading begins (`e.url` contains the source)
+- `load` - fires when content has loaded
+- `error` - fires on load failures (`e.url`, `e.message`)
+## 2. Communication between WebViews and Titanium
+### Local web content communication
+Logging from WebView:
+Ti.API methods work inside local HTML.
+```html
+<html>
+  <body onload="Ti.API.info('Page loaded!');">
+    <p>Logging works!</p>
+  </body>
+</html>
+```
+Bidirectional events with `Ti.App`:
+In local HTML:
+```html
+<html>
+  <head>
+    <script>
+      // Listen for events from Titanium
+      Ti.App.addEventListener('app:fromTitanium', (e) => {
+        alert(e.message);
+        document.getElementById('output').textContent = e.message;
+      });
+      // Send event to Titanium
+      function sendToApp() {
+        Ti.App.fireEvent('app:fromWebView', {
+          message: 'Hello from WebView!'
+        });
+      }
+    </script>
+  </head>
+  <body>
+    <button onclick="sendToApp()">Send to Titanium</button>
+    <div id="output"></div>
+  </body>
+</html>
+```
+In Titanium:
+```javascript
+const webview = Ti.UI.createWebView({ url: 'local.html' });
+// Listen for events from the WebView
+Ti.App.addEventListener('app:fromWebView', (e) => {
+  alert(e.message);
+});
+// Send event to the WebView
+const button = Ti.UI.createButton({
+  title: 'Send to WebView'
+});
+button.addEventListener('click', () => {
+  Ti.App.fireEvent('app:fromTitanium', {
+    message: 'Hello from Titanium!'
+  });
+});
+```
+### Remote web content communication
+Titanium statements (`Ti.API`, `Ti.App`) do not work in remote HTML content.
+Warning: On iOS 12.0+, calling `evalJS()` synchronously from some contexts can deadlock. Prefer the async version with a callback.
+#### Using `evalJS()` for remote content
+Inject JavaScript and retrieve results as strings:
+```javascript
+const webview = Ti.UI.createWebView({ url: 'https://example.com' });
+webview.addEventListener('load', (e) => {
+  // Get the page title
+  const title = webview.evalJS('document.title');
+  Ti.API.info(`Page title: ${title}`);
+  // Get cookies
+  const cookies = webview.evalJS('document.cookie');
+  Ti.API.info(`Cookies: ${cookies}`);
+  // Execute a custom function
+  webview.evalJS('alert("Hello from Titanium!");');
+});
+```
+`evalJS()` rules:
+- Call it from the `load` event (page must be loaded)
+- Pass code as a single string
+- Returns a string (or null)
+- Use `JSON.stringify()` for complex data
+#### Passing data to remote content
+```javascript
+webview.addEventListener('load', () => {
+  const data = { user: 'John', score: 100 };
+  webview.evalJS(`window.appData = ${JSON.stringify(data)};`);
+});
+```
+Then in remote HTML:
+```html
+<script>
+  console.log(window.appData.user); // 'John'
+</script>
+```
+## 3. Performance and interaction concerns
+### WebView performance
+WebView consumes significant resources:
+- Each WebView has its own rendering context
+- Memory overhead is high
+- Load time is independent of content complexity
+Best practice: if you can recreate the content with native Titanium components, do it.
+### WebView in TableViews
+Anti-pattern: embedding WebViews in TableViewRows causes slow scrolling.
+### WebView in scrollable components
+WebViews do not behave well inside other scrollable containers (ScrollView, TableView). They consume touch events.
+Workaround: set `touchEnabled: false` on the WebView if it sits inside a scrollable parent:
+```javascript
+const webview = Ti.UI.createWebView({
+  url: 'content.html',
+  touchEnabled: false // Allow parent to handle touches
+});
+```
+### Viewport meta tag
+For mobile-optimized content, use the viewport meta tag:
+```html
+<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+```
+## 4. WebView use cases
+Common WebView use cases:
+- HTML forms: auto-scroll to focused fields, next/previous navigation, native keyboard integration
+- Rich text or HTML email: render styled content that is hard to replicate with native labels
+- Canvas/graphics: HTML5 Canvas provides 2D drawing not available in native Titanium APIs
+- OAuth flows: load third-party auth pages in a WebView and intercept redirects
+### Authentication flows
+Many OAuth providers use WebView for login (for example, the Facebook module).
+```javascript
+const authWebView = Ti.UI.createWebView({
+  url: 'https://auth.example.com/oauth'
+});
+authWebView.addEventListener('load', (e) => {
+  // Detect redirect to callback URL with token
+  if (e.url.indexOf('myapp://callback') === 0) {
+    const token = extractTokenFromUrl(e.url);
+    Ti.App.fireEvent('auth:success', { token: token });
+  }
+});
+```
+### Canvas and graphics
+For complex graphics, use HTML5 Canvas:
+`local.html`:
+```html
+<canvas id="myCanvas" width="300" height="200"></canvas>
+<script>
+  const ctx = document.getElementById('myCanvas').getContext('2d');
+  ctx.fillStyle = 'green';
+  ctx.fillRect(10, 10, 150, 100);
+</script>
+```
+## 5. WKWebView behavioral differences (iOS)
+- Cookies: WKWebView uses a separate cookie store from `Ti.Network`. Cookies set via HTTPClient are not shared with WebViews.
+- `localStorage`/`sessionStorage`: not shared between the native app and the WebView. Each WKWebView has its own storage.
+- `evalJS` is async: on iOS 12.0+, synchronous `evalJS()` can deadlock. Use the callback form instead:
+```javascript
+webView.evalJS('document.title', (result) => {
+  Ti.API.info(`Title: ${result}`);
+});
+```
+- Viewport meta tag required: WKWebView needs an explicit viewport tag to scale content correctly:
+```html
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+```
+- Custom fonts: use a special `@font-face` path format in WKWebView CSS. Fonts must be in the app bundle and referenced correctly.
+- Remote HTML limitations: `Ti.API`, `Ti.App.fireEvent()`, and other Titanium calls do not work in remotely-loaded HTML. Only local HTML can communicate with the Titanium runtime.
+## Best practices summary
+1. Avoid WebViews when possible. Use native components.
+2. Never embed a WebView in a TableView.
+3. Use local content for integration. Only local content supports `Ti.App` events.
+4. Use `evalJS()` for remote content. It is the only way to interact with remote pages.
+5. Wait for the `load` event before calling `evalJS()`.
+6. Configure the viewport for proper mobile rendering.

package/skills/ti-howtos/references/webpack-build-pipeline.md ADDED Viewed

@@ -0,0 +1,125 @@
+# Webpack build pipeline
+> **⚠️ Appcelerator/Axway era feature**
+> The Webpack pipeline documented here was introduced with Titanium SDK 9.1.0 as part of the Axway AMPLIFY toolchain (`appcd` daemon). Since Axway discontinued Appcelerator, this feature is **not maintained** in the current TiDev CLI (`ti`). If you are using the community TiDev CLI, this pipeline may not be available. Prefer the standard `ti build` pipeline unless your project already uses Webpack.
+Webpack integration is an alternative build pipeline starting with Titanium SDK 9.1.0. It is optional. When enabled, Webpack manages asset and code bundling.
+## 1. Key benefits
+- Fast incremental builds: only changed files are processed.
+- npm support: install packages in the root and import them directly.
+- Build-time resolution: `require` calls are resolved during compilation, not at runtime.
+## 2. The `@` alias
+Webpack adds the `@` alias to reference the source root without deep relative paths.
+| Project type | Path mapped by `@` |
+| :----------- | :----------------- |
+| Alloy        | `app/lib`          |
+| Classic      | `src`              |
+Usage example:
+```javascript
+// Before (without webpack)
+import Utils from '../../utils/helper';
+// Now (with webpack)
+import Utils from '@/utils/helper';
+```
+## 3. npm dependency management
+Install a package in the project root:
+```bash
+npm install lodash
+```
+Use it in Titanium code:
+```javascript
+import _ from 'lodash';
+const data = _.chunk(['a', 'b', 'c', 'd'], 2);
+```
+## 4. Platform-specific files
+Webpack detects platform-specific files using the `filename.<platform>.js` pattern.
+Example:
+- `utils.js` (common)
+- `utils.ios.js` (iOS only)
+- `utils.android.js` (Android only)
+When you `import { func } from '@/utils'`, Webpack picks the correct version for the build target.
+## 5. Diagnostic web UI
+Webpack includes a web interface to analyze builds and asset sizes.
+Default URL: `http://localhost:1732/webpack/latest/web`
+## 6. Project plugins
+Webpack support is powered by plugins chosen based on project type:
+| Plugin                             | Purpose                 |
+| ---------------------------------- | ----------------------- |
+| `@appcd/webpack-plugin-alloy`      | Alloy project support   |
+| `@appcd/webpack-plugin-classic`    | Classic project support |
+| `@appcd/webpack-plugin-babel`      | Babel transpilation     |
+| `@appcd/webpack-plugin-typescript` | TypeScript support      |
+### Custom plugin configuration
+Customize with the `webpack-chain` API in `webpack.config.js`:
+```javascript
+module.exports = (api) => {
+  // Add a custom alias
+  api.chainWebpack((config) => {
+    config.resolve.alias.set('@utils', api.resolve('app/lib/utils'));
+  });
+};
+```
+Common customizations:
+- Add alias: `config.resolve.alias.set(name, path)`
+- Add loader: `config.module.rule(name).use(name).loader(loader)`
+- Delete plugin: `config.plugins.delete(name)`
+## 7. Advanced configuration
+Extend configuration via plugins in `package.json`:
+```json
+{
+  "appcdWebpackPlugins": [
+    "my-local-plugin.js"
+  ]
+}
+```
+## 8. Global configuration
+Configure Webpack daemon settings in `~/.appcelerator/appcd/config.json`:
+```json
+{
+  "webpack": {
+    "inactivityTimeout": 600000
+  }
+}
+```
+## 9. Troubleshooting
+Build seems stuck: the Webpack daemon may need a restart.
+```bash
+appcd exec /webpack/latest/stop
+```
+View build logs:
+```bash
+appcd logcat "*webpack*"
+```
+## 10. Known limitations
+- Hyperloop is not compatible with the Webpack pipeline.
+- Alloy.jmk build hooks are not supported. Use Webpack plugins instead.
+- The first build may be slower due to daemon startup.