@caperjs/core 0.7.2 → 0.7.3

package/cli/native.mjs

@@ -18,6 +18,16 @@ const IDENTIFIER_RE = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9-]*)+$/;
 const PLACEHOLDER_IDENTIFIER = 'com.tauri.dev';
 const DEFAULT_IDENTIFIER_PREFIX = 'dev.caper.';
 
+/** A window/app title from a package name: strip an npm scope, split on `-`/`_`/`.`, capitalize each word. */
+export function displayTitle(packageName) {
+  return String(packageName ?? '')
+    .replace(/^@[^/]+\//, '')
+    .split(/[-_.\s]+/)
+    .filter(Boolean)
+    .map((word) => word[0].toUpperCase() + word.slice(1))
+    .join(' ');
+}
+
 /** Strip an npm scope, lowercase, collapse non `[a-z0-9]` runs to `-`, trim `-`. */
 export function appSlug(packageName) {
   return String(packageName ?? '')
@@ -219,7 +229,7 @@ export async function initNative(cwd, opts = {}, { run = defaultRun } = {}) {
   // vars can instead reflect an unrelated ancestor process (e.g. a monorepo
   // task runner). Read the name straight from the package.json we already have.
   const name = pkg.name ?? 'app';
-  const title = opts.title ?? name;
+  const title = opts.title ?? displayTitle(name);
   const slug = appSlug(pkg.name ?? name);
 
   const identifier = opts.identifier ?? defaultIdentifier(slug);
@@ -244,7 +254,7 @@ export async function initNative(cwd, opts = {}, { run = defaultRun } = {}) {
     'init',
     '--ci',
     '--app-name',
-    name,
+    title,
     '--window-title',
     title,
     '--frontend-dist',
@@ -262,7 +272,10 @@ export async function initNative(cwd, opts = {}, { run = defaultRun } = {}) {
   const tauriConf = JSON.parse(fs.readFileSync(tauriConfPath, 'utf-8'));
   writeJson(tauriConfPath, patchTauriConfig(tauriConf, { identifier, title }), 2);
 
-  writeJson(pkgPath, patchPackageScripts(pkg), detectIndent(pkgRaw));
+  // Re-read: the package manager rewrote package.json when it added @tauri-apps/cli,
+  // and patching the copy read above would silently drop that devDependency.
+  const freshPkgRaw = fs.readFileSync(pkgPath, 'utf-8');
+  writeJson(pkgPath, patchPackageScripts(JSON.parse(freshPkgRaw)), detectIndent(freshPkgRaw));
 
   if (opts.icon) {
     run(EXEC_RUNNER[pm], ['tauri', 'icon', opts.icon], { cwd });
@@ -666,7 +679,7 @@ export async function androidNative(
 }
 
 function printUsage() {
-  console.error(red('Usage: caper native init [--identifier <id>] [--port <n>] [--icon <png>]'));
+  console.error(red('Usage: caper native init [--title <name>] [--identifier <id>] [--port <n>] [--icon <png>]'));
   console.error(red('       caper native plugin'));
   console.error(red('       caper native android'));
 }
@@ -687,6 +700,10 @@ function parseInitArgs(args) {
       const next = args[++i];
       if (!next) throw new Error('Missing value for --icon');
       opts.icon = next;
+    } else if (arg === '--title') {
+      const next = args[++i];
+      if (!next) throw new Error('Missing value for --title');
+      opts.title = next;
     } else {
       throw new Error(`Unknown option: ${arg}`);
     }

package/cli/native.test.mjs

@@ -14,6 +14,7 @@ import {
   commandsFor,
   defaultIdentifier,
   defaultPort,
+  displayTitle,
   findMainActivity,
   initNative,
   isValidIdentifier,
@@ -46,6 +47,14 @@ function makeTempDir() {
   return tempDir;
 }
 
+describe('displayTitle', () => {
+  it('title-cases a package name into a window title', () => {
+    expect(displayTitle('rhodora')).toBe('Rhodora');
+    expect(displayTitle('my-game')).toBe('My Game');
+    expect(displayTitle('@studio/space_rocks')).toBe('Space Rocks');
+  });
+});
+
 describe('appSlug', () => {
   it('strips a scope, lowercases, and collapses non-alnum runs to a hyphen', () => {
     expect(appSlug('@acme/My Game')).toBe('my-game');
@@ -315,6 +324,29 @@ describe('initNative', () => {
     };
   }
 
+  it('keeps the @tauri-apps/cli devDependency the package manager just added', async () => {
+    const dir = makeTempDir();
+    scaffoldApp(dir);
+    const calls = [];
+    const tauriRun = stubbedRun(calls);
+    // Like a real `pnpm add -D`, write the devDependency into package.json.
+    const run = (cmd, args, opts) => {
+      if (args[0] === 'add') {
+        const pkgPath = path.join(opts.cwd, 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        pkg.devDependencies = { ...pkg.devDependencies, '@tauri-apps/cli': '^2.12.1' };
+        fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+      }
+      return tauriRun(cmd, args, opts);
+    };
+
+    await initNative(dir, {}, { run });
+
+    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8'));
+    expect(pkg.devDependencies['@tauri-apps/cli']).toBe('^2.12.1');
+    expect(pkg.scripts['native:build']).toBe('tauri build');
+  });
+
   it('does nothing and makes zero run calls when src-tauri already exists', async () => {
     const dir = makeTempDir();
     scaffoldApp(dir);
@@ -360,9 +392,9 @@ describe('initNative', () => {
       'init',
       '--ci',
       '--app-name',
-      'my-game',
+      'My Game',
       '--window-title',
-      'my-game',
+      'My Game',
       '--frontend-dist',
       '../dist',
       '--dev-url',
@@ -375,7 +407,7 @@ describe('initNative', () => {
 
     const conf = JSON.parse(fs.readFileSync(path.join(dir, 'src-tauri/tauri.conf.json'), 'utf-8'));
     expect(conf.identifier).toBe('dev.caper.mygame');
-    expect(conf.app.windows[0]).toMatchObject({ title: 'my-game', width: 1280, height: 720 });
+    expect(conf.app.windows[0]).toMatchObject({ title: 'My Game', width: 1280, height: 720 });
     expect(conf.app.security.csp).toBeNull();
     expect(conf.bundle).toEqual({ active: true, targets: ['app'] });
 

package/extras/llms.txt

@@ -219,7 +219,7 @@ subcommands run from the app root.
 | `caper doctor [--offline] [--json]` | One-screen health check: installed vs latest caper, npm vs linked engine (and whether the linked build is stale), generated types present/fresh, asset manifest, agent pointers, peer deps, caches. Exit 1 on any ✗. |
 | `caper agent init [--dir <skillsDir>]` | Install the shipped `caper` agent skill (default `.claude/skills/caper/SKILL.md`) and upsert a pointer block into `AGENTS.md`/`CLAUDE.md`. Re-run after upgrading caper. |
 | `caper agent probe <url> [--action n[=json]]… [--until "<js predicate>"] [--wait ms] [--screenshot p] [--headed] [--json]` | Drive a **running** app headlessly through the automation bridge (§17) in a Chromium you own: boots, sends actions, waits on state, returns context/state/log/errors (+ screenshot). Needs `playwright` in the app's devDependencies. |
-| `caper native init [--identifier <id>] [--port <n>] [--icon <png>]` | One-shot Tauri v2 scaffolding: adds `@tauri-apps/cli`, runs `tauri init --ci`, pins a `dev.caper.*`-style identifier + a stable non-3000 dev port, adds `native:dev`/`native:build` scripts. No-ops with "already initialized" if `src-tauri/` exists. |
+| `caper native init [--title <name>] [--identifier <id>] [--port <n>] [--icon <png>]` | One-shot Tauri v2 scaffolding: adds `@tauri-apps/cli`, runs `tauri init --ci`, names the app and window after the package (title-cased: `my-game` → "My Game"; `--title` overrides), pins a `dev.caper.*`-style identifier + a stable non-3000 dev port, adds `native:dev`/`native:build` scripts. No-ops with "already initialized" if `src-tauri/` exists. |
 | `caper native plugin` | Wires an already-`native init`'d app up for `@caperjs/plugin-tauri`: adds its JS deps, runs `tauri add store`, and patches the window permissions it needs into `capabilities/default.json`. Fails with "run `caper native init` first" if `src-tauri/` is missing; idempotent otherwise. |
 | `caper native android` | Sets an already-`native init`'d app up for Android: finds the SDK/NDK/JDK/rustup, adds the four Android Rust targets, runs `tauri android init --ci`, adds 16 KB page alignment to `build.rs`, hides the system bars in `MainActivity.kt`, adds `native:android:dev`/`native:android:build` scripts. Idempotent; warns instead of overwriting files you changed. |
 | `caper update` | Update Caper to latest. |
@@ -834,6 +834,15 @@ then push toasts to it. Also available as `app.popups.toast(...)`.
 
 A FlexContainer preset for app-size-bound HUDs. Use as the root of in-game UI.
 
+It pads by the device safe-area insets (notch, camera hole, gesture bar) by
+default. `useSafeArea: false` turns that off; `{ top: false }` turns off one
+edge, e.g. to let corner buttons sit in a punch-hole phone's camera strip:
+
+```ts
+import { isAndroid, isTauri } from '@caperjs/core';
+const hud = this.add.uiCanvas({ useAppSize: true, useSafeArea: isTauri && isAndroid ? { top: false } : true });
+```
+
 ### 7.6 `Joystick` — virtual stick
 
 For touch input. Wires into the `controls.touch.joystick` bindings set via