@maccesar/titools 5.1.0 → 5.2.0

package/README.md

@@ -6,7 +6,7 @@
 
 </div>
 
-TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 11 skills — 6 specialist skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-synthengine`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering reuse and simplification, Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling and resource automation, UI/UX patterns, 2D games, and native sound synthesis.
+TiTools is a Titanium SDK toolkit for AI coding assistants. It ships 13 skills — 8 specialist skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`) plus 5 documentation-mirror skills (`ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`) — a research agent, and reference files covering reuse and simplification, Titanium architecture, API reference, native how-tos, Alloy MVC, PurgeTSS styling and resource automation, UI/UX patterns, 2D games, and native sound synthesis.
 
 The reference files are maintained against official documentation whenever an official source exists, so the assistant can retrieve current framework behavior instead of guessing from generic training data. As of v5.0.0 those sources are the Titanium SDK's own API definitions and the rewritten guides at [titaniumsdk.com](https://titaniumsdk.com). [Where the references come from](#where-the-references-come-from) has the detail.
 
@@ -36,7 +36,7 @@ The fastest way to get started with Claude Code. One command to add the marketpl
 ```
 
 What you get:
-- All 11 TiTools skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-synthengine`, `ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`)
+- All 13 TiTools skills (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`, `ti-api`, `ti-guides`, `ti-howtos`, `alloy-guides`, `alloy-howtos`)
 - ti-pro research agent
 - Session hook that auto-detects Titanium projects (`tiapp.xml`, Alloy, PurgeTSS, `ti.game`, `ti.synthengine`)
 - Slash commands: `/ti-check`, `/ti-new-screen`, `/ti-audit`
@@ -70,7 +70,7 @@ claude   # or gemini, or codex
 ```
 
 What gets installed:
-- The 10 TiTools skills to `~/.agents/skills/`
+- The 13 TiTools skills to `~/.agents/skills/`
 - ti-pro agent for Claude Code
 - Platform symlinks for Claude Code (Gemini CLI and Codex CLI auto-discover from `~/.agents/skills/` — no symlinks needed)
 - Knowledge index in your project's `AGENTS.md`/`CLAUDE.md`/`GEMINI.md`
@@ -179,7 +179,9 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | purgetss     | Alloy styling + asset automation    | Utility classes; Alloy/Classic branding, images, colors, fonts and modules |
 | ti-ui        | UI/UX patterns                      | Complex layouts, ListViews, platform UI |
 | ti-game      | 2D games with the `ti.game` module  | Sprites, physics, tile layers, wall jumps, pathfinding, text/performance HUDs, particles, camera |
-| ti-synthengine | Sound design with `ti.synthengine` | Tones, chords, retro/UI effects, alarms, sweeps, patterns, mixing and troubleshooting |
+| ti-game-assets | Visual and sound assets | Image generation/editing, synthesis variants, stereo placement, alpha cleanup, manifests, parallax and complete exports |
+| ti-synthengine | Sound design with `ti.synthengine` | Tones, chords, retro/UI effects, alarms, sweeps, patterns, ADSR envelopes, resonant filters, FM, detune, binaural positioning, engine statistics, mixing and troubleshooting |
+| ti-admob-unified | Advertising, privacy and mediation | Official `ti.admob.unified` guides, copy-ready library, banners/fullscreen, UMP/ATT and selected-provider configuration |
 | ti-api       | Complete Titanium API reference     | Looking up properties, methods, events  |
 | ti-guides    | SDK fundamentals                    | tiapp.xml, Hyperloop, distribution, JDK/Xcode compatibility, release notes |
 | ti-howtos    | Native feature integration          | Location, push, media, platform APIs    |
@@ -187,10 +189,11 @@ The knowledge index is based on the latest Titanium SDK documentation. If your p
 | alloy-howtos | Alloy CLI, configuration, debugging | alloy.jmk, config.json, custom XML tags |
 
 Notes:
-- The first six (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-synthengine`) are specialist workflow skills reflecting TiTools' Titanium conventions and native-module contracts.
+- The first eight (`ti-reuse-first`, `ti-expert`, `purgetss`, `ti-ui`, `ti-game`, `ti-game-assets`, `ti-synthengine`, `ti-admob-unified`) are specialist workflow skills reflecting TiTools' Titanium conventions and native-module contracts.
 - `ti-reuse-first` runs before the others. It asks whether a thing needs to exist and what already does it — a search order that stops at the first rung that holds — and sweeps an existing `app/` for near-identical controllers, single-listener events, wrappers around one call, and layout recomputed in JavaScript. It is deliberately two-sided: it says when adding a module or a Widget is the right answer, so the bias does not simply invert.
 - `ti-game` documents the `ti.game` native module (2D sprite engine on OpenGL ES 2.0, Android and iOS). Its API reference was verified against the module source and tracks upstream `main` (the module ships features ahead of its manifest version); it applies to Alloy and Classic projects alike and does not depend on PurgeTSS.
-- `ti-synthengine` translates aesthetic sound requests into strict, production-ready JavaScript for the cross-platform `ti.synthengine` 1.0.0 module. Seven references preserve the official documentation and an eighth adds curated retro, xylophone, memory-pad, polyphony and timer-ownership recipes; the API contract was cross-checked against both native implementations.
+- `ti-synthengine` translates aesthetic sound requests into strict, production-ready JavaScript for the cross-platform `ti.synthengine` 1.0.0 beta module. Eight references preserve official documentation, accompanied by raw statistics benchmark trials; curated recipes add retro effects, xylophone interaction, memory pads, polyphony and timer ownership. The reviewed source includes eleven public methods with optional diagnostics; feature detection remains necessary for older beta binaries. Maintenance notes and a hash manifest distinguish the reviewed working tree from its base commit and published packages, track preserved navigation and state audit limits.
+- `ti-game-assets` treats images and sounds as essential game assets. It coordinates integrated `image_gen` artwork with `ti-synthengine` sound design, variants and stereo placement, and ships Pillow helpers for conservative alpha cleanup and per-world visual/audio manifests.
 - The latter five are documentation-mirror skills, audited against official sources via the internal `titools-skill-auditor`. See [Where the references come from](#where-the-references-come-from).
 - `purgetss` reference files are audited against the official PurgeTSS documentation and against the package source (the CLI and the generated `utilities.tss`), but its workflow conventions are opinionated.
 
@@ -274,7 +277,7 @@ TiTools provides slash commands for common tasks. Both channels ship them: the p
 These commands automatically invoke the relevant skills:
 - `/ti-check` reads `tiapp.xml`, validates declared native modules, and reports project health
 - `/ti-new-screen` uses `ti-expert` + `purgetss` to create properly structured files
-- `/ti-audit` routes all 11 skills: the reuse sweep first, core Titanium checks always, Alloy/PurgeTSS checks when detected, integration how-tos when used, and `ti-game` / `ti-synthengine` checks when those modules are declared
+- `/ti-audit` routes all 13 skills: the reuse sweep first, core Titanium checks always, Alloy/PurgeTSS checks when detected, integration how-tos when used, `ti-game-assets` checks for game asset workflows, and `ti-game` / `ti-synthengine` / `ti-admob-unified` checks when those modules are declared
 
 ---
 
@@ -318,6 +321,8 @@ All skills include automatic project detection to ensure compatibility:
 | ti-expert | Alloy vs Classic      | Checks for `app/` (Alloy) vs `Resources/` (Classic) structure |
 | ti-ui     | Titanium projects     | Checks for `tiapp.xml` (both Alloy and Classic)               |
 | ti-game   | ti.game module        | Checks for `<module>ti.game</module>` in `tiapp.xml` or `require('ti.game')` |
+| ti-game-assets | Game art/sound workflows | Reads asset inventories, generation/export workflows and requested visual or sound assets; no module install required for drawings |
+| ti-admob-unified | ti.admob.unified and mediation | Declared core/complement modules or requested ad/privacy/provider integration |
 | ti-synthengine | ti.synthengine module | Checks for `<module>ti.synthengine</module>` in `tiapp.xml` or `require('ti.synthengine')` |
 
 Why this matters:
@@ -333,11 +338,12 @@ Why this matters:
 | --- | --- |
 | Whether to build it at all | `ti-reuse-first`, first |
 | Architecture and UI | `ti-expert`, `ti-ui`, `purgetss` when configured |
-| Native modules | `ti-game`, `ti-synthengine` when declared |
+| Game assets | `ti-game-assets` for visual and sound creation, preparation and integration |
+| Native modules | `ti-game`, `ti-synthengine`, `ti-admob-unified` when declared or requested |
 | Exact SDK/API guidance | `ti-api`, `ti-guides`, `ti-howtos` |
 | Alloy MVC and tooling | `alloy-guides`, `alloy-howtos` for Alloy projects |
 
-All eleven ship with TiTools; no second skill package is required.
+All thirteen ship with TiTools; no second skill package is required.
 
 ---
 
@@ -502,14 +508,37 @@ Key rules:
 
 ---
 
+### ti-game-assets
+
+Create game art and sound assets as a coherent set: transparent HD masters or strict logical-grid pixel art, animation states, three-layer parallax, synthesized effects/music/ambience, related sound variants and screen-position stereo. `ti-game` owns native game behavior and `ti-synthengine` owns the sound contract; the asset skill coordinates both.
+
+For the processing helpers and development tests, install Python dependencies in a virtual environment:
+
+```bash
+python3 -m venv /tmp/titools-assets-env
+/tmp/titools-assets-env/bin/pip install -r skills/ti-game-assets/scripts/requirements.txt
+TITOOLS_ASSETS_PYTHON=/tmp/titools-assets-env/bin/python npm test
+```
+
+Raster drawing generation/editing uses integrated `image_gen`. Authored SVG/procedural pipelines preserve editable sources and deterministically export PNG; offline synthesis can generate WAV. The bundled Python helpers validate alpha, SVG provenance, hashes and WAV headers/payloads. Cleaning writes new files and requires a reviewed protected region or an explicit defined-edge trial. Sound recipes remain source assets even without recorded audio files. Guides cover seamless texture/audio loops and responsible ad transitions through the separate `ti-admob-unified` skill. Technical checks, visual inspection and device listening are reported separately.
+
+### ti-admob-unified
+
+Integrate César's `ti.admob.unified` module in Alloy or Classic using its official documentation for installation, API, UMP/ATT, privacy options, banner layout, fullscreen lifecycle and mediation. The skill includes the official copy-ready application library and guides for AppLovin, Meta, InMobi, Unity and Liftoff. The module's first public 1.0.0 release is under preparation at this snapshot.
+
+Source commit, per-file hashes and rebased links are recorded. Future updates use the maintainer auditor's source map and the read-only check `node scripts/verify-module-snapshot.mjs --source /path/to/ti.admob.unified`; new, changed or removed docs are reported before updating. Community guidance remains separate from official mirrors.
+
+Installing an adapter does not configure a publisher account or prove delivery. The skill distinguishes build/linking, Google test ads, each provider's test delivery and physical-device acceptance; it preserves the game's selected frequency policy instead of enabling every format.
+
 ### ti-synthengine
 
-Cross-platform sound design and synthesis with the native `ti.synthengine` 1.0.0 module for Android and iOS.
+Cross-platform sound design and synthesis with the native `ti.synthengine` 1.0.0 beta module for Android and iOS.
 
 When it activates:
 - `tiapp.xml` declares `ti.synthengine`, or code calls `require('ti.synthengine')`
 - The app needs generated UI feedback, game cues, retro/chiptune effects, alarms, chords, pads, noise percussion, sweeps, panning, or vibrato
 - A synth call returns `false`, the first sound glitches, a pattern stops, a chord pumps, or output changes after a route switch
+- The app needs voice/queue/rejection counters, optional render-load/output meters, or help interpreting host benchmark evidence
 
 Example prompts:
 ```
@@ -527,6 +556,7 @@ Key rules:
 - `playTone` accepts `note` or `frequency`, never both; `playChord` accepts `notes` or `frequencies`, never both
 - `duration` includes attack, the full-level middle, and release, so explicit envelope times must intersect correctly
 - Use `frequencyEnd` for sweeps, `panEnd` for stereo movement, and `lfoFreq`/`lfoDepth` for pitch vibrato
+- Binaural headphone positioning uses `spatialX`/`spatialY` from -1 to 1, without pan fields. Omit both to keep stereo; check installed coordinate limits because older 1.0.0 builds lack this beta addition
 - Curated recipes cover retro effects, playable xylophone gestures, four-pad memory cues, controlled waveform comparisons, layered chords and cancellable repetition
 - Start after the first layout settles, keep one lifecycle owner, check Boolean returns, and call `shutdown()` on cleanup
 
@@ -627,7 +657,7 @@ Behavior depends on where you run it:
 | With `--local` flag        | Installs skills locally to `./.agents/skills/` in the current project |
 
 What it does:
-- Installs the 10 TiTools skills (global or local depending on context)
+- Installs the 13 TiTools skills (global or local depending on context)
 - Installs ti-pro agent for Claude Code
 - Installs the `/ti-check`, `/ti-new-screen` and `/ti-audit` slash commands into `~/.claude/commands/`
 - Detects installed AI platforms and lets you choose which to link (only Claude Code needs platform symlinks; Gemini CLI and Codex CLI auto-discover from `~/.agents/skills/`)
@@ -836,7 +866,9 @@ This pattern is documented across four bundled TiTools skills: `ti-ui`, `ti-expe
 | purgetss  | Setup + Critical Rules        | 34 files (Classic compatibility, grid, animations, icons, class-index, SVG pipeline, etc.) |
 | ti-ui     | UI Rules + Platform Diffs     | 14 files (layouts, lists, gestures, etc.)             |
 | ti-game   | Native 2D Game Workflow       | 9 files (API, setup, patterns, recipes, tile maps, debugging, roadmap) |
-| ti-synthengine | Native Sound Synthesis   | 8 files (API, sound design, lifecycle, engine, official examples, curated recipes, recommendations, troubleshooting) |
+| ti-game-assets | Visual and Sound Assets | 10 guides and a manifest example; alpha and contract validation scripts |
+| ti-admob-unified | Unified Advertising | 11 official module guides, source/hash update checks, official example library and game integration guidance |
+| ti-synthengine | Native Sound Synthesis   | 10 Markdown references (8 official, curated recipes, maintenance notes), raw statistics trials and a source hash manifest |
 
 ---
 

package/agents/ti-pro.md

@@ -7,7 +7,9 @@ skills:
   - purgetss
   - ti-ui
   - ti-game
+  - ti-game-assets
   - ti-synthengine
+  - ti-admob-unified
   - ti-api
   - ti-guides
   - ti-howtos
@@ -29,8 +31,10 @@ When invoked, research complex topics by consulting the applicable skills from t
 - `ti-expert` - Architecture, patterns, conventions
 - `purgetss` - Utility-first styling classes (optional add-on; use when the project already has it or the user asks about it)
 - `ti-ui` - UI/UX patterns, layouts, gestures
+- `ti-game-assets` - Visual and sound asset contracts, raster generation, alpha/export validation, synthesis variants and stereo coordination when assets are involved
 - `ti-game` - Native `ti.game` architecture and API when the module is declared
 - `ti-synthengine` - Native sound synthesis and strict `ti.synthengine` contract when the module is declared
+- `ti-admob-unified` - Official unified advertising/privacy/mediation module contract and provider setup when declared or requested
 - `ti-api`, `ti-guides`, `ti-howtos` - Exact Titanium APIs, SDK fundamentals and native integrations
 - `alloy-guides`, `alloy-howtos` - Alloy MVC, CLI, configuration and compiler workflows when the project is Alloy
 

package/commands/ti-audit.md

@@ -25,6 +25,10 @@ Native-module audit:
 10. If the project declares `ti.game`, invoke `ti-game` — check for sprites moved from timers instead of native properties, levels sized from `Ti.Platform.displayCaps` instead of the `resize` event, sprites added one by one instead of in one array, and timers or sounds left running when the window closes.
 11. If the project declares `ti.synthengine`, invoke `ti-synthengine` — check strict option names and types, mutually exclusive pitch fields, valid envelope intersections, checked Boolean results, one clear lifecycle owner, delayed startup after layout, app-owned timer cancellation, and `shutdown()` cleanup.
 
+12. If the project has game art/sound inventories or asset-generation/export workflows, invoke `ti-game-assets` — check contracts per set, master provenance/transparency, protected alpha cleanup, frame/pivot alignment, complete derived exports, parallax layers, sound variants and semantic event bindings. Consult `ti-game` and `ti-synthengine` equally in their applicable domains; do not require module installation or new sounds for an image-only task.
+
+13. If the project declares `ti.admob.unified`/mediation complements or implements an ad flow through this module, invoke `ti-admob-unified` — verify official module APIs, consent/request eligibility/initialization, test IDs, banner layout and refresh ownership, deliberate fullscreen presentation, callback cleanup and selected-provider mappings. Separate linking, Google test ads, provider delivery and physical acceptance. In games preserve native pause/audio/input ownership and the existing frequency policy.
+
 If a conditional skill does not apply, record it as `not applicable` with the detected reason instead of inventing findings from it.
 
 Report findings grouped by severity: critical, warning, info.

package/lib/config.js

@@ -35,7 +35,9 @@ export const SKILLS = [
   'purgetss',
   'ti-ui',
   'ti-game',
+  'ti-game-assets',
   'ti-synthengine',
+  'ti-admob-unified',
   'ti-api',
   'ti-guides',
   'ti-howtos',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maccesar/titools",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Titanium SDK skills and agents for AI coding assistants, including native game and sound synthesis modules",
   "main": "lib/index.js",
   "type": "module",

package/skills/purgetss/SKILL.md

@@ -329,7 +329,7 @@ purgetss create 'MyApp' -d -v fa
 > ```
 
 - **NEVER add `composite` class explicitly** - That's the default, use `horizontal`/`vertical` when needed
-- **Arbitrary values use parentheses**: `w-(100)`, `bg-(#ff0000)` - NO square brackets, and no `px` unit (unitless values are pixels; since v7.8.0 `w-(100px)` stops the build with a `Class Syntax Error`)
+- **Arbitrary values use parentheses**: `w-(100)`, `bg-(#ff0000)` - NO square brackets. A unitless value is resolved through `ti.ui.defaultunit` (see [values-and-units.md](references/values-and-units.md)); `w-(100px)` is explicit pixels, valid again since v7.18.0 after stopping the build from v7.8.0 through v7.17.1
 - **`mode: 'all'` required** in `config.cjs` for Ti Elements styling
 - **Classes use `kebab-case`**: `.my-class`, IDs use `camelCase`: `#myId`
 
@@ -427,7 +427,7 @@ Load these only when needed:
 - [CLI Commands](references/cli-commands.md) - All `purgetss` commands
 - [Color Commands](references/color-commands.md) - `semantic`, `shades` and `color-module`: Light/Dark semantic colors, palettes in `config.cjs`, and the CommonJS color module
 - [Adopting PurgeTSS](references/adopting-purgetss.md) - Moving an existing Alloy app from hand-written `.tss` files to utility classes: the style-priority trap, view-by-view workflow, and property-to-class translation tables
-- [Migration Guide](references/migration-guide.md) - Upgrading between PurgeTSS versions (v7.2.6 → v7.17.1): breaking changes and what to review after each upgrade
+- [Migration Guide](references/migration-guide.md) - Upgrading between PurgeTSS versions (v7.2.6 → v7.18.0): breaking changes and what to review after each upgrade
 - **[Values and Units](references/values-and-units.md)** - How `ti.ui.defaultunit` in `tiapp.xml` interprets the unitless numeric values PurgeTSS writes (foundational concept for spacing, sizes, typography)
 
 ### Customization
@@ -445,7 +445,7 @@ Load these only when needed:
 - [Grid Layout System](references/grid-layout.md) - 12-column grid, responsive layouts
 - [Smart Mappings](references/smart-mappings.md) - How gap, shadows, and grid work under the hood
 - [Arbitrary Values](references/arbitrary-values.md) - Parentheses notation for custom values
-- [Platform Modifiers](references/platform-modifiers.md) - ios:, android:, tablet:, handheld:
+- [Platform Modifiers](references/platform-modifiers.md) - ios:, android:, tablet:, handheld:, and stacked `ios:tablet:` (v7.18.0)
 - [Opacity Modifier](references/opacity-modifier.md) - Color transparency with /50 syntax
 - [Titanium Resets](references/titanium-resets.md) - Default styles for Ti elements
 - [iOS Large Titles](references/ios-large-titles.md) - Best practice for iOS Large Title navigation
@@ -471,7 +471,7 @@ Load these only when needed:
 - [PurgeTSS UI in Classic](references/purgetss-ui-classic.md) - Native JavaScript setup, public exports, animation objects, cleanup, and platform notes
 
 ### Release Notes
-- [Version History](references/version-history.md) - Release-by-release feature additions and behavior changes (v7.4.0 → v7.17.1)
+- [Version History](references/version-history.md) - Release-by-release feature additions and behavior changes (v7.4.0 → v7.18.0)
 
 > **💡 TEXT FONTS (Google Fonts, Roboto, etc.)**
 > For text fonts, see [Custom Fonts](references/custom-fonts.md).

package/skills/purgetss/references/EXAMPLES.md

@@ -321,14 +321,14 @@ alloy compile
 <View class="w-(100) bg-(#ff0000)" />
 ```
 
-**PurgeTSS syntax for arbitrary values uses `()` not `[]`, and pixel values are written without a unit: `w-(100px)` also stops the build (`Explicit "px" unit is redundant`).**
+**PurgeTSS syntax for arbitrary values uses `()` not `[]`. A unitless value follows `ti.ui.defaultunit`; `w-(100px)` is explicit pixels (it stops the build only on v7.8.0 through v7.17.1).**
 
 > **🚨 v7.8.0+ HARD-FAILS THE BUILD ON SQUARE BRACKETS**
 > Since v7.8.0, the build stops with a structured `Class Syntax Error` block (file path + line number + `Fix:` suggestion) the moment it spots `top-[10px]`, `wh-[12]`, or any other square-bracket utility. Pre-v7.8.0, those classes silently dropped into the `// Unused or unsupported classes` block of `app.tss` — easy to miss. Now they're loud and actionable.
 >
 > v7.10.1 reworded the error message from `'Tailwind-style brackets "[ ]" are not supported'` to `'Square brackets "[ ]" are not supported'`. Same enforcement, less framing.
 >
-> See [Arbitrary Values → Class syntax pre-validation](arbitrary-values.md#class-syntax-pre-validation) for the full list of patterns the pre-validator catches (5 total, including inverted negative sign, whitespace inside parentheses, and redundant `px` units).
+> See [Arbitrary Values → Class syntax pre-validation](arbitrary-values.md#class-syntax-pre-validation) for the full list of patterns the pre-validator catches (4 since v7.18.0: inverted negative sign, square brackets, empty parentheses, and whitespace inside parentheses).
 
 **Examples:**
 - `w-(100)` - Custom width
@@ -434,7 +434,7 @@ module.exports = {
 | `w-full`                              | Percentage-based                     | `w-screen` (Ti.UI.FILL)                      |
 | `rounded-full` with `w-*`/`h-*`       | Fixed 8×8 circle, conflicts on size  | `rounded-full-12`                            |
 | `composite` class                     | Already default                      | Omit it                                      |
-| `w-[100]`, `w-(100px)`                | Stops the build (v7.8.0+)            | `w-(100)`                                    |
+| `w-[100]`                             | Stops the build (v7.8.0+)            | `w-(100)`                                    |
 | Manual `.tss`                         | Duplicates classes; its rules override `app.tss` | Use utility classes (`app.tss` itself is rewritten on every run) |
 | `gap` on a `%`-width column           | Total exceeds 100%                   | `gap-*` on an inner View, or explicit margins |
 | ScrollView without `content-*` sizing | No/unexpected scroll                 | Add `content-w-screen` + `content-h-auto`    |

package/skills/purgetss/references/adopting-purgetss.md

@@ -103,7 +103,7 @@ Once the converted view looks right on both platforms, and the user agrees:
 | `layout: 'vertical'` | `vertical` |
 | `elevation: 4` | `elevation-1` (the scale is ×4: `elevation-4` is `16`) |
 
-Spacing classes multiply by 4 (`mt-4` = 16), and the numbers are unitless: Titanium resolves them with `ti.ui.defaultunit` (see [values-and-units.md](values-and-units.md)). For a value off the scale use an arbitrary value **without a unit**: `h-(60)`, not `h-(60px)`, which stops the build since v7.8.0 (see [arbitrary-values.md](arbitrary-values.md)). Colors in your brand palette belong in `config.cjs` (see [customization-deep-dive.md](customization-deep-dive.md)), not in arbitrary `bg-(#hex)` classes repeated across views.
+Spacing classes multiply by 4 (`mt-4` = 16), and the numbers are unitless: Titanium resolves them with `ti.ui.defaultunit` (see [values-and-units.md](values-and-units.md)). For a value off the scale use an arbitrary value: `h-(60)` keeps the default unit, while `h-(60px)` means explicit pixels and stops the build on v7.8.0 through v7.17.1 (see [arbitrary-values.md](arbitrary-values.md)). Colors in your brand palette belong in `config.cjs` (see [customization-deep-dive.md](customization-deep-dive.md)), not in arbitrary `bg-(#hex)` classes repeated across views.
 
 ### Platform and device conditionals
 
@@ -133,5 +133,5 @@ See [animation-system.md](animation-system.md).
 | Keeping inline attributes (`backgroundColor="…"`) | They override every class | Move them into classes |
 | Flexbox classes (`flex-row`, `justify-between`) | Classes don't exist | `horizontal` / `vertical` layouts |
 | `p-*` on a `View` or `Window` | No effect: `padding` exists only on `TextField`, `TextArea` and Android `CardView` | Margins on the children |
-| `w-[100]` or `w-(100px)` | Stops the build | `w-(100)` |
+| `w-[100]` | Stops the build | `w-(100)` |
 | Converting every view at once | Hard to find what broke | One view per step, tested on both platforms |

package/skills/purgetss/references/animation-advanced.md

@@ -204,7 +204,7 @@ Control how draggable views behave when dropped. All are **off by default**.
 | `snap-center` | `{ animationProperties: { snap: { center: true } } }` | Auto-centers on target |
 | `snap-center-false` | `{ animationProperties: { snap: { center: false } } }` | Disables snap-center |
 
-Generated utility inventories may still contain `snap-magnet` names, but the current `purgetss.ui` runtime never reads `animationProperties.snap.magnet`. Do not use or recommend those classes as working drag behavior.
+There is no magnet snap: `snap-magnet` and `snap-magnet-false` were generated from v7.5.1 through v7.17.1, but the runtime never read `snap.magnet`, and v7.18.0 removed them.
 
 ### keep-z-index
 
@@ -307,7 +307,7 @@ The callback is a new object containing selected native primitives plus PurgeTSS
 
 ### Position and drag state
 
-`swap()`, `snapTo()`, and `reorder()` persist destinations with `applyProperties()` and update private origin fields. They fall back to rendered `rect` coordinates, so call them only after layout.
+`swap()`, `snapTo()`, and `reorder()` persist destinations with `applyProperties()` and update private origin fields. They fall back to rendered `rect` coordinates, so call them only after layout. `swap()` has this fallback since v7.18.0; before, a source view with no `top`/`left` sent the target view to `top: undefined`.
 
 Drag precedence is precise:
 

package/skills/purgetss/references/arbitrary-values.md

@@ -49,7 +49,7 @@ Example output:
 
 ### Detected patterns
 
-The validator catches five narrow, actionable mistakes:
+The validator catches four narrow, actionable mistakes:
 
 | Pattern                       | Offending input | Suggested fix | Notes                                                            |
 | ----------------------------- | --------------- | ------------- | ---------------------------------------------------------------- |
@@ -57,13 +57,14 @@ The validator catches five narrow, actionable mistakes:
 | Square-bracket notation       | `top-[10]`      | `top-(10)`    | PurgeTSS uses parentheses, not square brackets, for arbitrary values (v7.10.1 reworded the error from `Tailwind-style brackets "[ ]"` to `Square brackets "[ ]" are not supported`) |
 | Empty parentheses             | `wh-()`         | (flagged, no auto-fix) | Add a value such as `wh-(10)`                           |
 | Whitespace inside parentheses | `wh-( 200 )`    | `wh-(200)`    | No spaces allowed between `(`, the value, and `)`                |
-| Redundant `px` unit           | `top-(10px)`    | `top-(10)`    | PurgeTSS treats unit-less arbitrary values as pixels             |
+
+From v7.8.0 through v7.17.1 there was a fifth pattern, "Redundant `px` unit", which rejected `top-(10px)` and suggested `top-(10)`. v7.18.0 removed it: its error text claimed unit-less values are pixels, but they resolve through `ti.ui.defaultunit`, so the suggested fix changed the size.
 
 ### Unknown classes are still silently dropped
 
-The pre-validator only fires on the five patterns above. Any other unknown class — typos, custom utilities not yet declared, vendor classes that are not enabled in `config.cjs` — is **not** reported as a `Class Syntax Error`. Those classes continue to flow into the `// Unused or unsupported classes` comment block in `app.tss`, exactly like before. This keeps the validator focused on actionable mistakes and avoids noise while you sketch out class names.
+The pre-validator only fires on the four patterns above. Any other unknown class — typos, custom utilities not yet declared, vendor classes that are not enabled in `config.cjs` — is **not** reported as a `Class Syntax Error`. Those classes continue to flow into the `// Unused or unsupported classes` comment block in `app.tss`, exactly like before. This keeps the validator focused on actionable mistakes and avoids noise while you sketch out class names.
 
-> **Units: write arbitrary values unitless.** Because of the redundant-`px` rule, any class like `m-(50px)`, `w-(2300px)` or `text-(48px)` halts the purge. Write `m-(50)`, `w-(2300)`, `text-(48)` instead; other units such as `rem`, `in` or `%` are not flagged.
+> **Units.** A unitless value such as `w-(100)` generates `width: 100`, which Titanium resolves through `ti.ui.defaultunit` (normally `dp`; see [values-and-units.md](values-and-units.md)). A value with a unit keeps it: `w-(100px)` generates `width: '100px'`, explicit pixels, and `rem`, `in` or `%` work the same way. On v7.8.0 through v7.17.1 a `px` suffix stops the purge; write `w-(100)` there only if `dp` is what you meant.
 
 ### v7.8.0 parser fix for negatives inside parentheses
 
@@ -182,9 +183,11 @@ You can set an arbitrary value for any of the following color properties:
 - `bg-` (*hex-rgb-or-rgba-value*)
 - `bg-disabled-` (*hex-rgb-or-rgba-value*)
 - `bg-focused-` (*hex-rgb-or-rgba-value*)
+- `bg-from-` (*hex-rgb-or-rgba-value*) — v7.18.0; earlier versions wrote a literal `{value1}`
 - `bg-selected-` (*hex-rgb-or-rgba-value*)
 - `bg-selected-from-` (*hex-rgb-or-rgba-value*)
 - `bg-selected-to-` (*hex-rgb-or-rgba-value*)
+- `bg-to-` (*hex-rgb-or-rgba-value*)
 - `border-` (*hex-rgb-or-rgba-value*)
 - `colors-` (*hex-rgb-or-rgba-value*)
 - `content-scrim-` (*hex-rgb-or-rgba-value*)
@@ -236,7 +239,7 @@ You can set an arbitrary value for any of the following color properties:
 
 ## Spacing Properties
 
-You can set arbitrary values for most size and dimension properties using unitless numbers or units such as `rem`, `in`, or `%`, directly in XML files or in `config.cjs`. A `px` suffix is rejected by the pre-validator (see above).
+You can set arbitrary values for most size and dimension properties using unitless numbers or units such as `px`, `rem`, `in`, or `%`, directly in XML files or in `config.cjs`. A `px` suffix is rejected on v7.8.0 through v7.17.1 (see above).
 
 ```xml
 <Alloy>

package/skills/purgetss/references/class-categories.md

@@ -1,6 +1,6 @@
 # PurgeTSS Class Categories
 
-Every class family in `utilities.tss` (PurgeTSS 7.17.1), grouped by the kind of value it sets. Generated by `.claude/skills/titools-skill-auditor/scripts/purgetss-class-index.mjs`; do not edit by hand. For the property-by-property table see [class-index-properties.md](./class-index-properties.md); for naming rules see [class-index.md](./class-index.md).
+Every class family in `utilities.tss` (PurgeTSS 7.18.0), grouped by the kind of value it sets. Generated by `.claude/skills/titools-skill-auditor/scripts/purgetss-class-index.mjs`; do not edit by hand. For the property-by-property table see [class-index-properties.md](./class-index-properties.md); for naming rules see [class-index.md](./class-index.md).
 
 <!-- TOC-START -->
 ## Contents
@@ -288,7 +288,7 @@ Every class family in `utilities.tss` (PurgeTSS 7.17.1), grouped by the kind of
 | `item-content-type-uttype-*` | 33 | `itemContentType` | `item-content-type-uttype-text`, `item-content-type-uttype-tiff`, `item-content-type-uttype-apple-protected-mpeg4-audio` |
 | `keyboard-appearance`, `keyboard-appearance-dark`, `keyboard-appearance-light` | 3 | `keyboardAppearance` | — |
 | `keyboard-dismiss-mode-none`, `keyboard-dismiss-mode-on-drag`, `keyboard-dismiss-mode-interactive` | 3 | `keyboardDismissMode` | — |
-| `keyboard-type`, `keyboard-type-*` | 14 | `keyboardType` | `keyboard-type-decimal-pad`, `keyboard-type-phone-pad`, `keyboard-type-appearance-light` |
+| `keyboard-type`, `keyboard-type-*` | 11 | `keyboardType` | `keyboard-type-decimal-pad`, `keyboard-type-numbers-punctuation`, `keyboard-type-url` |
 | `kind-contacts-organization`, `kind-contacts-person` | 2 | `kind` | — |
 | `large-title-display-mode-automatic`, `large-title-display-mode-always`, `large-title-display-mode-never` | 3 | `largeTitleDisplayMode` | — |
 | `layer-type-web-view-none`, `layer-type-web-view-software`, `layer-type-web-view-hardware` | 3 | `layerType` | — |
@@ -301,7 +301,7 @@ Every class family in `utilities.tss` (PurgeTSS 7.17.1), grouped by the kind of
 | `location-services-authorization-denied`, `location-services-authorization-restricted`, `location-services-authorization-unknown`, `location-services-authorization-always`, `location-services-authorization-when-in-use` | 5 | `locationServicesAuthorization` | `location-services-authorization-denied`, `location-services-authorization-unknown`, `location-services-authorization-when-in-use` |
 | `lock-screen-setting-not-supported`, `lock-screen-setting-enabled`, `lock-screen-setting-disabled` | 3 | `lockScreenSetting` | — |
 | `lockscreen-visibility-private`, `lockscreen-visibility-public`, `lockscreen-visibility-secret` | 3 | `lockscreenVisibility` | — |
-| `login-keyboard-type`, `login-keyboard-type-*` | 14 | `loginKeyboardType` | `login-keyboard-type-appearance`, `login-keyboard-type-namephone-pad`, `login-keyboard-type-url` |
+| `login-keyboard-type`, `login-keyboard-type-*` | 11 | `loginKeyboardType` | `login-keyboard-type-decimal-pad`, `login-keyboard-type-numbers-punctuation`, `login-keyboard-type-url` |
 | `login-return-key-type-*` | 12 | `loginReturnKeyType` | `login-return-key-type-continue`, `login-return-key-type-join`, `login-return-key-type-yahoo` |
 | `media-type-music-all`, `media-type-music-any-audio`, `media-type-music-audiobook`, `media-type-music`, `media-type-music-podcast` | 5 | `mediaType` | `media-type-music-all`, `media-type-music-audiobook`, `media-type-music-podcast` |
 | `media-types-*` | 18 | `mediaTypes` | `media-types-music-type-all`, `media-types-video-type-closed-caption`, `media-types-video-type` |
@@ -321,7 +321,7 @@ Every class family in `utilities.tss` (PurgeTSS 7.17.1), grouped by the kind of
 | `outputs-audio-session-port-*` | 14 | `outputs` | `outputs-audio-session-port-linein`, `outputs-audio-session-port-builtinspeaker`, `outputs-audio-session-port-caraudio` |
 | `over-scroll-mode-always`, `over-scroll-mode-if-content-scrolls`, `over-scroll-mode-never` | 3 | `overScrollMode` | — |
 | `override-user-interface-style-unspecified`, `override-user-interface-style-light`, `override-user-interface-style-dark` | 3 | `overrideUserInterfaceStyle` | — |
-| `password-keyboard-type`, `password-keyboard-type-*` | 14 | `passwordKeyboardType` | `password-keyboard-type-appearance`, `password-keyboard-type-namephone-pad`, `password-keyboard-type-url` |
+| `password-keyboard-type`, `password-keyboard-type-*` | 11 | `passwordKeyboardType` | `password-keyboard-type-decimal-pad`, `password-keyboard-type-numbers-punctuation`, `password-keyboard-type-url` |
 | `password-return-key-type-*` | 12 | `passwordReturnKeyType` | `password-return-key-type-continue`, `password-return-key-type-join`, `password-return-key-type-yahoo` |
 | `physical-size-category-large`, `physical-size-category-normal`, `physical-size-category-small`, `physical-size-category-undefined`, `physical-size-category-xlarge` | 5 | `physicalSizeCategory` | `physical-size-category-large`, `physical-size-category-small`, `physical-size-category-xlarge` |
 | `platform-w`, `platform-h`, `platform-wh`, `platform-w-inverted`, `platform-h-inverted`, `platform-wh-inverted`, `inverted-platform-w`, `inverted-platform-h` | 8 | `width`, `height` | `platform-w`, `platform-wh`, `platform-wh-inverted` |
@@ -650,7 +650,7 @@ Each sets one property to `true` or `false`. Most come as a pair, `name` and `na
 - `show-vertical-scroll-indicator` / `show-vertical-scroll-indicator-false`
 - `shows-controls` / `shows-controls-false`
 - `smooth-scroll-on-tab-click` / `smooth-scroll-on-tab-click-false`
-- `snap-back` / `snap-back-false` / `snap-center` / `snap-center-false` / `snap-magnet` / `snap-magnet-false` / `keep-z-index` / `keep-z-index-false`
+- `snap-back` / `snap-back-false` / `snap-center` / `snap-center-false` / `keep-z-index` / `keep-z-index-false`
 - `sorted` / `sorted-false`
 - `split-track` / `split-track-false`
 - `stopped` / `stopped-false`

package/skills/purgetss/references/class-index-properties.md

@@ -1,6 +1,6 @@
 # PurgeTSS Class Index — Titanium Properties (A–Z)
 
-Every Titanium property that has PurgeTSS utility classes, with the classes that set it. Generated from `utilities.tss` (PurgeTSS 7.17.1) by `.claude/skills/titools-skill-auditor/scripts/purgetss-class-index.mjs`; do not edit by hand. For naming rules and verification commands see [class-index.md](./class-index.md); for classes grouped by kind of value see [class-categories.md](./class-categories.md).
+Every Titanium property that has PurgeTSS utility classes, with the classes that set it. Generated from `utilities.tss` (PurgeTSS 7.18.0) by `.claude/skills/titools-skill-auditor/scripts/purgetss-class-index.mjs`; do not edit by hand. For naming rules and verification commands see [class-index.md](./class-index.md); for classes grouped by kind of value see [class-categories.md](./class-categories.md).
 
 > Before suggesting ANY class, verify it exists: `grep -E "PATTERN" ./purgetss/styles/utilities.tss`
 
@@ -78,10 +78,10 @@ A property set inside `font` or `animationProperties` is listed with its contain
 | `animationProperties.close` | `opacity-to-0`, `opacity-to-100`, `toggle-visible` | 3 | Animation | — |
 | `animationProperties.close` | `zoom-*` | 30 | Animation | — |
 | `animationProperties.complete` | `zoom-*` | 30 | Animation | — |
-| `animationProperties.keepZIndex` | `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `snap-magnet`, `snap-magnet-false`, `keep-z-index`, `keep-z-index-false` | 8 | Animation | — |
+| `animationProperties.keepZIndex` | `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `keep-z-index`, `keep-z-index-false` | 6 | Animation | — |
 | `animationProperties.open` | `opacity-to-0`, `opacity-to-100`, `toggle-visible` | 3 | Animation | — |
 | `animationProperties.open` | `zoom-*` | 30 | Animation | — |
-| `animationProperties.snap` | `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `snap-magnet`, `snap-magnet-false`, `keep-z-index`, `keep-z-index-false` | 8 | Animation | — |
+| `animationProperties.snap` | `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `keep-z-index`, `keep-z-index-false` | 6 | Animation | — |
 | `animationStyle` | `animation-style-*` | 14 | ListViewAnimationProperties, TableViewAnimationProperties, closeWindowParams | iOS only |
 | `appSupportsShakeToEdit` | `app-supports-shake-to-edit`, `app-supports-shake-to-edit-false` | 2 | iOS | — |
 | `arrowDirection` | `arrow-direction-*` | 11 | CameraOptionsType, PhotoGalleryOptionsType, MenuPopupShowParams, iPad.Popover | some variants platform-only |
@@ -388,7 +388,7 @@ A property set inside `font` or `animationProperties` is listed with its contain
 | `keyboardDisplayRequiresUserAction` | `keyboard-display-requires-user-action`, `keyboard-display-requires-user-action-false` | 2 | WebView | — |
 | `keyboardToolbarColor` | `keyboard-toolbar-*` | 245 | TextArea, TextField | — |
 | `keyboardToolbarHeight` | `keyboard-toolbar-h-*` | 35 | TextArea, TextField | — |
-| `keyboardType` | `keyboard-type`, `keyboard-type-*` | 14 | AlertDialog, SearchBar, TextArea, TextField | — |
+| `keyboardType` | `keyboard-type`, `keyboard-type-*` | 11 | AlertDialog, SearchBar, TextArea, TextField | — |
 | `keyboardVisible` | `keyboard-visible`, `keyboard-visible-false` | 2 | Ti.App | — |
 | `kind` | `kind-contacts-organization`, `kind-contacts-person` | 2 | Ti.App.iOS.SearchableItemAttributeSet, Ti.Contacts.Person | — |
 | `largeTitleDisplayMode` | `large-title-display-mode-automatic`, `large-title-display-mode-always`, `large-title-display-mode-never` | 3 | NavigationWindow, TabGroup, Window, iOS.SplitWindow | iOS only |
@@ -422,7 +422,7 @@ A property set inside `font` or `animationProperties` is listed with its contain
 | `locationServicesEnabled` | `location-services-enabled`, `location-services-enabled-false` | 2 | Ti.Geolocation | — |
 | `lockScreenSetting` | `lock-screen-setting-not-supported`, `lock-screen-setting-enabled`, `lock-screen-setting-disabled` | 3 | GetUserNotificationSettings | iOS only |
 | `lockscreenVisibility` | `lockscreen-visibility-private`, `lockscreen-visibility-public`, `lockscreen-visibility-secret` | 3 | Ti.Android.NotificationChannel | Android only |
-| `loginKeyboardType` | `login-keyboard-type`, `login-keyboard-type-*` | 14 | AlertDialog | — |
+| `loginKeyboardType` | `login-keyboard-type`, `login-keyboard-type-*` | 11 | AlertDialog | — |
 | `loginReturnKeyType` | `login-return-key-type-*` | 12 | AlertDialog | — |
 | `looping` | `looping`, `looping-false` | 2 | Ti.Media.Sound | — |
 | `mainFrameOnly` | `main-frame-only`, `main-frame-only-false` | 2 | UserScriptParams | — |
@@ -503,7 +503,7 @@ A property set inside `font` or `animationProperties` is listed with its contain
 | `pagingControlTimeout` | `paging-control-timeout-*` | 22 | ScrollableView | — |
 | `paragraphSpacingAfter` | `paragraph-spacing-after-*` | 64 | ParagraphAttribute | — |
 | `paragraphSpacingBefore` | `paragraph-spacing-before-*` | 64 | ParagraphAttribute | — |
-| `passwordKeyboardType` | `password-keyboard-type`, `password-keyboard-type-*` | 14 | AlertDialog | — |
+| `passwordKeyboardType` | `password-keyboard-type`, `password-keyboard-type-*` | 11 | AlertDialog | — |
 | `passwordMask` | `password-mask`, `password-mask-false` | 2 | TextField | — |
 | `passwordReturnKeyType` | `password-return-key-type-*` | 12 | AlertDialog | — |
 | `pathOnly` | `path-only`, `path-only-false` | 2 | PhotoGalleryOptionsType | — |

package/skills/purgetss/references/class-index.md

@@ -1,7 +1,7 @@
 # PurgeTSS Class Index
 
 <!-- GENERATED:counts START -->
-**Generated from `utilities.tss` (PurgeTSS 7.17.1): 23,343 unique classes, 403 first segments, 620 Titanium properties.** Counts grow with each Titanium SDK and icon-font release.
+**Generated from `utilities.tss` (PurgeTSS 7.18.0): 23,332 unique classes, 403 first segments, 620 Titanium properties.** Counts grow with each Titanium SDK and icon-font release.
 <!-- GENERATED:counts END -->
 
 Before suggesting ANY class, verify it exists:
@@ -258,7 +258,7 @@ The rest of this document collects conventions, prohibitions, and insights surfa
 
 ## All First Segments (Alphabetical)
 
-> **NOTE**: v7.4.0 introduced `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `snap-magnet`, `snap-magnet-false`, `keep-z-index`, and `keep-z-index-false`. The current runtime implements back, center, and touch-start z-index preservation but does not read `snap.magnet`; do not suggest the generated magnet classes as working behavior. v7.5.3 added `font-sans`, `font-serif`, and `font-mono`.
+> **NOTE**: v7.4.0 introduced `snap-back`, `snap-back-false`, `snap-center`, `snap-center-false`, `snap-magnet`, `snap-magnet-false`, `keep-z-index`, and `keep-z-index-false`. The runtime never read `snap.magnet`, and v7.18.0 removed `snap-magnet` and `snap-magnet-false`. v7.5.3 added `font-sans`, `font-serif`, and `font-mono`.
 
 
 <!-- GENERATED:prefixes START -->

package/skills/purgetss/references/cli-commands.md

@@ -346,7 +346,7 @@ purgetss images background/                           # re-process one subfolder
 | `--ios` | Only emit iPhone scale variants. Mutually exclusive with `--android`. |
 | `--format <ext>` | Convert all outputs to `webp`, `jpeg`, `png`, `avif`, `gif`, or `tiff`. Default: keep source format. |
 | `--quality <n>` | Quality `0-100` for `webp`, `jpeg`, `avif` and `tiff`. PNG and GIF ignore it. Default `85`. |
-| `--width <n>` | (v7.8.0) Pin Android `mdpi` (= iPhone `@1x`) to `<n>` pixels wide. Larger scales derive as ×1.5, ×2, ×3, ×4 from that base; height stays proportional to the source's aspect ratio. Integer in `[1, 8192]`. |
+| `--width <n>` | (v7.8.0) Pin Android `mdpi` (= iPhone `@1x`) to `<n>` pixels wide. Larger scales derive as ×1.5, ×2, ×3, ×4 from that base; height stays proportional to the source's aspect ratio. Integer in `[1, 1024]`. |
 | `--opacity <n>` | (v7.10.0) Multiply alpha of every density by `n/100`. Integer in `[0, 100]`. With `--format jpeg`, alpha flattens on white. |
 | `--padding <n>` | (v7.10.0) Shrink the rendered image inside each density canvas by `n%` symmetric borders. Integer in `[0, 40]`. |
 | `--output <relpath>` | (v7.10.0) Override the basename and subpath relative to each platform's `images/` root. |
@@ -458,7 +458,7 @@ purgetss il [-v=fa,mi,ms,f7] [-m] [-s]
 | `-m, --module` | Copy the matching CommonJS module into `app/lib/` (Alloy) or `Resources/lib/` (Classic). |
 | `-s, --styles` | Alloy only: copy official `.tss` sources into `purgetss/styles/` for reference. Classic skips this output. |
 
-Vendor aliases: `fa`/`fontawesome`, `mi`/`materialicons`, `ms`/`materialsymbol`, `f7`/`framework7`.
+Vendor aliases: `fa`/`fontawesome`, `mi`/`materialicons`, `ms`/`materialsymbol`/`materialsymbols` (v7.18.0), `f7`/`framework7`. An unknown value stops the command before it writes anything and lists the valid ones (v7.18.0).
 
 Every installed module exposes `families.default`. Direct variant aliases are `solid`/`regular`/`brands` for Font Awesome; `regular`/`outlined`/`round`/`sharp`/`twoTone` for Material Icons; `outlined`/`rounded`/`sharp` for Material Symbols; and `fontFamily` for Framework7.
 

package/skills/purgetss/references/dynamic-component-creation.md

@@ -123,7 +123,7 @@ classes: [
 // Arbitrary values use parentheses notation
 classes: [
   'w-(160)',          // Custom width
-  'h-(12.5rem)',      // Custom height with a unit (not px: a px suffix stops the build)
+  'h-(12.5rem)',      // Custom height with a unit
   'bg-(#3b82f6)',     // Custom hex color
   'm-(10dp)',         // Custom margin with unit
   'border-(2)'        // Custom border width
@@ -265,7 +265,7 @@ function createFormField(fieldType, options) {
 >
 > - `$` is the controller instance, so `$.UI.create()` is not available in a plain `app/lib/` CommonJS module, and PurgeTSS does not scan `app/lib/` for classes.
 > - Each class list is written out in full under `classes:`. A shared `baseClasses` array spread into `classes: [...baseClasses, ...]` is invisible to the scanner: spread elements are skipped and the array itself is not under a `classes:` key, so those classes would be purged from `app.tss`.
-> - `px-4` sets `padding`, which exists only on `Ti.UI.TextField`, `Ti.UI.TextArea` (Android and iOS) and `Ti.UI.Android.CardView` (apidoc 13_4_1_GA). The `// padding - Android Only` comment in `utilities.tss` is inaccurate for the two text inputs.
+> - `px-4` sets `padding`, which exists only on `Ti.UI.TextField`, `Ti.UI.TextArea` (Android and iOS) and `Ti.UI.Android.CardView` (apidoc 13_4_1_GA).
 
 ### Example 2: Dynamic List Items
 

package/skills/purgetss/references/grid-layout.md

@@ -83,7 +83,7 @@ The official source organizes the grid utilities into these categories. The stru
 
 ### Row Placement Utilities
 
-The official docs list these as `start`, `end`, and `center`, but no classes with those names exist in `utilities.tss`. The grid alignment classes PurgeTSS generates are:
+The grid alignment classes PurgeTSS generates are:
 
 | Class          | Generated rule                                  |
 | -------------- | ----------------------------------------------- |