@sublime-ui/devkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aaron Mkandawire and Sublime UI contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @sublime-ui/devkit
+
+The [Sublime UI](https://sublime-ui.github.io/sublime-ui/) developer CLI —
+code generators, the navigation compiler, desktop tooling, and **standalone
+Android APK builds fully offline** (no EAS / cloud build). Bin names: `sublime`
+(alias `sui`).
+
+## What "offline" means
+
+- **No cloud build service** — everything runs on your machine via Gradle.
+- **Offline runtime** — the default `assembleRelease` build embeds the JS bundle
+  and signs with the auto-generated debug keystore, so the APK runs with **no
+  Metro server**.
+- Not air-gapped: the *first* Gradle build still downloads Maven/AGP artifacts.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `sublime doctor` | Prints a ✓/✗ table for Node, JDK 17, `ANDROID_HOME`, cmdline-tools, platform-tools, NDK 27.1.12297006, CMake 3.22.1. Exits non-zero if a required piece is missing. |
+| `sublime setup` | Windows: installs a **portable Temurin JDK 17** into `~/.sublime/` (no admin; your system Java is untouched). macOS/Linux: prints guided steps. |
+| `sublime build [--release\|--debug] [--aab] [--project <path>]` | Runs `expo prebuild` if `android/` is absent, writes `local.properties`, then runs Gradle with a **scoped JDK 17** and self-heals missing NDK/CMake. Default = `assembleRelease`. Note: `--debug` produces a Metro-dependent APK (not offline); `--release` is the offline default. `--aab` produces a Play Store App Bundle (`.aab`, via bundleRelease). |
+| `sublime run [--device <id>] [--project <path>]` | `adb install -r` the APK and launches it. |
+
+## Code generators
+
+Scaffold code matching the Sublime UI framework/library conventions. Paths come
+from `sublime.config.json` (defaults: `src/models`, `src/components`, `src/theme`).
+
+| Command | Generates |
+|---|---|
+| `sublime make:model <Name> [--fields "a:string,b:number"] [--resource /path] [--force]` | `models/<Name>.ts` (Model + `declare` fields + `registerModel`) + barrel. No `--fields` → interactive prompts. |
+| `sublime make:component <Name> [--mobile-only] [--force]` | `components/<Name>/` quartet (`types`/`tsx`/`native.tsx`/`index`) + barrel. `--mobile-only` → web null stub. |
+| `sublime theme:init [--force]` | `theme/tokens.json` (= library defaults) + a typed `theme/tokens.ts` wrapper. |
+
+Generators never overwrite without `--force`; barrel updates are idempotent.
+
+## Navigation compiler
+
+| Command | What it does |
+|---|---|
+| `sublime build:nav [--watch] [--force] [--project <path>]` | Compiles per-platform storybooks (`storybook.web.ts` / `storybook.native.ts`) into `navigation.web.tsx` (react-router), `navigation.native.tsx` (React Navigation), a typed route map (`routes.d.ts`), and an index barrel. `--watch` rebuilds on change. |
+
+## Desktop (Electron Forge)
+
+| Command | What it does |
+|---|---|
+| `sublime desktop:dev [--project <path>]` | Runs the Electron desktop shell in development (`electron-forge start`). |
+| `sublime desktop:build [--project <path>]` | Builds distributable desktop artifacts (`electron-forge make`). |
+
+## Robustness (lessons baked in)
+
+- **Self-healing SDK installs.** On `Failed to install … ndk;X / cmake;Y`, the id
+  is parsed, installed via `sdkmanager`, and the build retried (max 4 attempts).
+- **Corrupt-NDK detection.** An NDK dir missing `source.properties` / `ndk-build`
+  / clang is removed and reinstalled.
+- **Modern cmdline-tools `sdkmanager` on JDK 17** avoids the legacy
+  `NoClassDefFoundError: javax/xml/bind` (JAXB removed after Java 8) crash.
+- **Scoped JDK.** Build children get `JAVA_HOME` → JDK 17 for that call only; the
+  system default Java is never modified.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| `doctor` shows JDK 17 ✗ | `sublime setup` (Windows) or install Temurin 17 + set `JAVA_HOME`. |
+| Build fails on `ndk;…`/`cmake;…` | Usually auto-healed; if it persists, check `ANDROID_HOME` is writable. |
+| `NoClassDefFoundError javax/xml/bind` | You're invoking the legacy `tools/bin/sdkmanager` on JDK 17 — use cmdline-tools `latest`. |
+| `run` finds no device | Start an emulator or plug in a phone with USB debugging; `adb devices`. |
+
+## Scope
+
+Offline Android builds are Android only (iOS needs macOS). macOS/Linux:
+`doctor`/`build`/`run` work; `setup` prints guided steps instead of
+auto-installing. Generators, `build:nav`, and the desktop commands are
+cross-platform.
+
+## Documentation
+
+Full CLI reference: **https://sublime-ui.github.io/sublime-ui/docs/devkit**
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }