@nativescript/cloudflare-cli 0.1.0-beta.7 → 0.1.0-beta.8

package/README.md

@@ -2,11 +2,12 @@
 
 ```sh
 npx @nativescript/cloudflare-cli live          # a phone app: opens the IDE and prints a QR code for NativeScript Preview
+npx @nativescript/cloudflare-cli live --react  # the same with a framework: --ng (Angular), --react, --vue, --svelte or --solid
 npx @nativescript/cloudflare-cli live --mac    # a Mac app: opens the IDE and runs the app on this Mac, streamed into the IDE
 npx @nativescript/cloudflare-cli live --electron   # an Electron app with native views, run the same way
 ```
 
-`live` creates a project on preview.nativescript.org (`--server` or `NS_EDGE_SERVER` for another edge), saves it to `.ns-edge.json` and opens its IDE. Run it again in the same folder to reopen that project (no platform flag needed), or add `--new` for another. While `live` runs a Mac app it restarts the app if it crashes, unless it crashes three times in a minute. Without a create token the project is free: a few hosted agent turns a day, no backend, deleted after 30 days unused. `--no-open` skips the browser; with `--mac` or `--electron`, `--allow-eval` lets the agent run code on this Mac.
+`live` creates a project on preview.nativescript.org (`--server` or `NS_EDGE_SERVER` for another edge), saves it to `.ns-edge.json` and opens its IDE. The framework flags are `ns create`'s (`--ng`/`--angular`, `--react`, `--vue`, `--svelte`, `--solid`, `--ts`); without one a phone project is plain TypeScript with XML views. Run it again in the same folder to reopen that project (no flag needed), or add `--new` for another; a flag for a different kind of project than the folder's asks for `--new`. While `live` runs a Mac app it restarts the app if it crashes, unless it crashes three times in a minute. Without a create token the project is free: a few hosted agent turns a day, no backend, deleted after 30 days unused. `--no-open` skips the browser; with `--mac` or `--electron`, `--allow-eval` lets the agent run code on this Mac.
 
 ## Mirror a local project
 

package/dist/bin.js

@@ -17,6 +17,26 @@ const DESKTOP_HOSTS = {
 };
 const DESKTOP_TEMPLATES = new Set(['macos', 'electron', 'expo']);
 const DESKTOP_FLAGS = { macos: 'mac', electron: 'electron', expo: 'expo' };
+/** The NativeScript CLI's `ns create` framework flags, so `live` and `create` take the same ones. */
+const FRAMEWORK_FLAGS = {
+    angular: ['ng', 'angular'],
+    react: ['react', 'reactjs'],
+    vue: ['vue', 'vuejs'],
+    svelte: ['svelte'],
+    solid: ['solid', 'solidjs'],
+    core: ['ts', 'tsc', 'typescript'],
+};
+const TEMPLATE_KINDS = {
+    core: 'a phone',
+    angular: 'an Angular phone',
+    react: 'a React phone',
+    vue: 'a Vue phone',
+    svelte: 'a Svelte phone',
+    solid: 'a Solid phone',
+    macos: 'a Mac',
+    electron: 'an Electron',
+    expo: 'an Expo Desktop',
+};
 const MAX_CRASHES = 3;
 const CRASH_WINDOW_MS = 60_000;
 const RESTART_DELAY_MS = 1000;
@@ -32,6 +52,22 @@ const flag = (name) => {
     return i >= 0 ? args[i + 1] : undefined;
 };
 const has = (name) => args.includes(`--${name}`);
+/** The template --template, a framework flag or a desktop flag asks for, if any; asking for two is an error. */
+function requestedTemplate() {
+    const asked = new Set();
+    const named = flag('template');
+    if (named)
+        asked.add(named);
+    for (const [template, names] of Object.entries(FRAMEWORK_FLAGS))
+        if (names.some((name) => has(name)))
+            asked.add(template);
+    for (const [template, name] of Object.entries(DESKTOP_FLAGS))
+        if (has(name))
+            asked.add(template);
+    if (asked.size > 1)
+        throw new Error(`Pick one kind of project: this asked for ${[...asked].join(' and ')}.`);
+    return [...asked][0];
+}
 const root = process.cwd();
 async function loadRef() {
     let ref;
@@ -130,14 +166,13 @@ const commands = {
                 throw new Error(`--${later} isn't available yet. Run \`live\` for a phone app, or \`live --mac\`, \`--electron\` or \`--expo\` for a Mac app.`);
         }
         let ref = has('new') ? null : await savedProject();
-        // Without a platform flag, this folder's project runs as whatever it was made as.
-        const template = flag('template') ?? Object.entries(DESKTOP_FLAGS).find(([, name]) => has(name))?.[0] ?? ref?.template ?? 'core';
+        const requested = requestedTemplate();
+        // Without a template flag, this folder's project runs as whatever it was made as.
+        const template = requested ?? ref?.template ?? 'core';
         const desktop = DESKTOP_TEMPLATES.has(template);
-        if (ref && DESKTOP_TEMPLATES.has(ref.template ?? 'core') !== desktop) {
-            throw new Error(`This folder's project (${CONFIG}) is a ${desktop ? 'phone' : 'Mac'} project. Add --new to replace it, or run this in another folder.`);
-        }
-        if (ref && desktop && ref.template !== template) {
-            throw new Error(`This folder's project (${CONFIG}) is a ${ref.template} project. Add --new to replace it, or run this in another folder.`);
+        if (ref && requested && (ref.template ?? 'core') !== requested) {
+            const current = TEMPLATE_KINDS[ref.template ?? 'core'] ?? `a ${ref.template}`;
+            throw new Error(`This folder's project (${CONFIG}) is ${current} project. Add --new to start ${TEMPLATE_KINDS[requested] ?? `a ${requested}`} one, or run this in another folder.`);
         }
         if (ref) {
             console.log(`Opening this folder's project ${ref.id} (${CONFIG})`);
@@ -145,8 +180,7 @@ const commands = {
         else {
             ref = await createProject(flag('server') ?? LIVE_SERVER, flag('token') ?? process.env.NS_EDGE_CREATE_TOKEN, template);
             await writeFile(join(root, CONFIG), JSON.stringify(ref, null, 2) + '\n');
-            const kind = template === 'electron' ? 'an Electron' : template === 'expo' ? 'an Expo Desktop' : desktop ? 'a Mac' : 'a phone';
-            console.log(`Created ${kind} project, saved to ${CONFIG} (it holds the project's keys: keep it private and out of git).`);
+            console.log(`Created ${TEMPLATE_KINDS[template] ?? `a ${template}`} project, saved to ${CONFIG} (it holds the project's keys: keep it private and out of git).`);
             if (ref.free) {
                 console.log(`It's a free project: ${ref.free.agentTurnsPerDay} hosted agent turn${ref.free.agentTurnsPerDay === 1 ? '' : 's'} a day, deleted after ${ref.free.idleDays} days unused. ` +
                     'For an unlimited agent, add your own API key in the agent panel or connect Claude Code from Connect agent.');
@@ -168,7 +202,7 @@ const commands = {
     },
     async create() {
         const server = flag('server') ?? 'http://localhost:5173';
-        const ref = await createProject(server, flag('token') ?? process.env.NS_EDGE_CREATE_TOKEN, flag('template'));
+        const ref = await createProject(server, flag('token') ?? process.env.NS_EDGE_CREATE_TOKEN, requestedTemplate());
         await writeFile(join(root, CONFIG), JSON.stringify(ref, null, 2) + '\n');
         console.log(`Created project ${ref.id} (saved to ${CONFIG}; it holds the project keys, keep it out of git)`);
         await printPairing(ref);
@@ -238,10 +272,12 @@ const commands = {
     async help() {
         console.log(`ns-edge <command>
 
-  live [--mac|--electron|--expo] [--new] [--no-open] [--allow-eval]
+  live [--ng|--react|--vue|--svelte|--solid|--mac|--electron|--expo] [--new] [--no-open] [--allow-eval]
                             create a project (or reopen this folder's), open its IDE, and print a QR code
-                            for your phone; --mac, --electron or --expo runs it on this Mac instead
-  create [--server <url>] [--token <t>] [--template core|vue|react|solid|svelte|angular]
+                            for your phone; --ng, --react, --vue, --svelte or --solid picks the framework
+                            (plain TypeScript with XML views otherwise); --mac, --electron or --expo runs it
+                            on this Mac instead
+  create [--server <url>] [--token <t>] [--ng|--react|--vue|--svelte|--solid|--template <name>]
                             create an edge project and save .ns-edge.json
   push                      upload app/ and server/ in one transaction
   watch                     push, then stream every save to the edge

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nativescript/cloudflare-cli",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "description": "Mirror a NativeScript project into an ns-edge project from a terminal or a Vite dev server",
   "license": "Apache-2.0",
   "type": "module",