feat!: sync with alloy v3.0.0

.gitignore

@@ -6,4 +6,8 @@ yarn-debug.log*
 yarn-error.log*
 
 # Dependency directories
-node_modules/
+node_modules/
+
+.DS_Store
+**/.DS_Store
+references/

CHANGELOG.md

@@ -3,6 +3,47 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 1.0.0-beta.0 (2026-05-12)
+
+Sync with upstream [Alloy v3.0.0](https://github.com/tidev/alloy/tree/3.0.0). Both `alloy-compiler` and `alloy-utils` jump from `0.2.7` to `1.0.0-beta.0` as the pre-release line for the v3 alignment.
+
+### BREAKING CHANGES
+
+* **node:** Minimum Node.js version is now `20.18.1` (was `10.0.0`).
+* **compiler:** Generated controller code shape changed in production builds (`retainLines: false`, ES6 module trimming, collection-binding null-safety). Compiled output of every component will differ from previous versions.
+* **compiler:** Babel transform now receives a `filename` argument, enabling `.babelrc` / `babel.config.js` discovery in downstream Alloy projects. Projects with one in scope will see their build behavior change.
+* **runtime:** Default Backbone version constant bumped to `1.6.0` (`SUPPORTED_BACKBONE_VERSIONS` updated in `alloy-utils`).
+* **runtime:** Vendored `moment` updated to 2.30.x; lang catalog expanded to 137 files (matches upstream).
+* **deps:** `chmodr` dependency removed; `lodash`, `@babel/*`, `fs-extra`, `source-map`, `moment`, `resolve`, `node.extend` version ranges bumped to match upstream v3.
+* **deps:** Legacy `jsonlint` and `xmldom` dependencies dropped from `alloy-utils` in favor of `@prantlf/jsonlint` and `@xmldom/xmldom`.
+
+### Features
+
+* Sync with Alloy v3.0.0 across `compile/parsers`, `compile/ast`, `compile/sourceMapper`, `compile/compilerUtils`, `compilers/component`, `builtins`, and `common/constants`.
+* Add 10 missing parser pass-throughs from upstream `31328743`: `Ti.UI.ActivityIndicator`, `Column`, `MaskedImage`, `Notification`, `ProgressBar`, `RefreshControl`, `Row`, `SearchBar`, `Shortcut`, `ShortcutItem`. Includes regression tests.
+* Generate source maps for widget library files (`ba8d4c22`).
+* Add end-to-end smoke snapshot test (`smoke.spec.js`) covering the `test-app` fixture component compile.
+
+### Bug Fixes
+
+* Restore `isNodeForCurrentPlatform` guard in `Alloy.Abstract._ItemContainer` so platform-filtered children are skipped correctly (`4f86263c`).
+* Use `path.join` in `sourceMapper.js` instead of manual string concat (`537107de`).
+* Skip widget sourcemap emission when sourcemaps are disabled (`b1259b1f`).
+* Fix broken `require('../../../tiapp')` import in `Ti.UI.OptionBar` parser (devkit-local pre-existing latent bug, surfaced during sync prep).
+* `Alloy.Abstract.Option.js` emits `const` declarations to avoid implicit-global assignment under strict mode (devkit delta on top of `93c2df14`; supersedes upstream `ce5b4b13`).
+
+### Chores
+
+* Rebrand attribution to TiDev, Inc. (`LICENSE` copyright, `package.json` author fields, repo URLs).
+* Delete stray `Ti.UI.OptionBar copy.js` parser file (accidental copy in tree).
+* Delete `Ti.UI.iPhone.NavigationGroup.js` parser (removed upstream prior to v3).
+* Document devkit-local divergences from upstream in `docs/DEVKIT_DELTAS.md`.
+* Ignore `.DS_Store` files and local `references/` directory.
+
+### Out-of-scope upstream commits
+
+For traceability, the following upstream commits since 1.15.2 were intentionally NOT ported because they touch files outside devkit's mirrored surface (CLI commands, app templates, runtime BaseController shipped with Titanium SDK, etc.): `e45d9300`, `f5cbdd5e`, `30d9f88c`, `9f273a67`, `fb845f73`, `36b2fc87`, `29a8a54c`, `86791bc5`. See commit messages on the sync branch for per-SHA justification.
+
 ## [0.2.7](https://github.com/appcelerator/alloy-devkit/compare/v0.2.6...v0.2.7) (2021-06-02)
 
 

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2019-present Axway Appcelerator
+   Copyright 2019-2026 TiDev, Inc.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

docs/DEVKIT_DELTAS.md

@@ -0,0 +1,28 @@
+# Devkit Deltas
+
+Intentional deviations from upstream Alloy that future syncs must preserve.
+
+## 1. Path/import convention
+
+All parsers and lib files under `packages/alloy-compiler/lib/` import shared utilities from the `alloy-utils` package rather than via relative paths. This is a structural rule, not a per-file delta — apply mechanically when porting:
+
+- `require('../../../utils')` → `require('alloy-utils').utils`
+- `require('../../../logger')` → `require('alloy-utils').logger`
+- `require('../../../tiapp')` → `require('alloy-utils').tiapp`
+- `require('../../../common/constants')` → `require('alloy-utils').constants`
+
+## 2. Package split
+
+Upstream Alloy ships as a single CLI; devkit splits the compile logic into two libraries: `alloy-compiler` (parsers, AST, compilers, builtins, templates) and `alloy-utils` (utils, logger, tiapp, constants, platforms, grammar). Out-of-scope upstream code: `Alloy/commands/{new,copy,move,debugger,extract-i18n,generate,info,install,purgetss,remove,test}`, `Alloy/plugin/`, top-level CLI bootstrap (`Alloy/alloy.js`).
+
+## 3. `Alloy.Abstract.Option.js` `const` patch
+
+Local fix on top of upstream `93c2df14` (`feat: support using OptionBar`). The upstream emit produces `${attrVarName} = ...` which assigns to an implicit global under strict mode. Devkit emits `const ${attrVarName} = ...` instead. Inline comment in the file points back to this entry.
+
+## 4. `Ti.UI.iPhone.NavigationGroup.js` removed
+
+Removed from devkit during the v3 sync. Upstream removed it earlier; a future sync should not re-add it as "missing file."
+
+## 5. Template variants
+
+`packages/alloy-compiler/template/{component,model}.es6.js` are devkit-only ES6-export-style templates with no upstream counterpart. They sit alongside the upstream-mirrored `component.js` / `model.js`. Out of upstream sync scope.

lerna.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.7",
+  "version": "1.0.0-beta.0",
   "npmClient": "yarn",
   "packages": [
     "packages/*"

package.json

@@ -16,5 +16,8 @@
     "jest": "^27.0.3",
     "lerna": "^4.0.0",
     "prettier": "^2.0.2"
+  },
+  "engines": {
+    "node": ">=20.18.1"
   }
 }