@legendapp/create-spark 0.0.1-next.5 → 0.0.1-next.7

package/README.md

@@ -9,9 +9,27 @@ cd MyApp
 npm run macos
 ```
 
+Choose a channel explicitly with any supported package manager:
+
+| Manager | Next preview | Latest |
+| --- | --- | --- |
+| npm | `npm create @legendapp/spark@next MyApp -- --next` | `npm create @legendapp/spark@latest MyApp -- --latest` |
+| Bun | `bun create @legendapp/spark@next MyApp --next` | `bun create @legendapp/spark@latest MyApp --latest` |
+| pnpm | `pnpm create @legendapp/spark MyApp --next` | `pnpm create @legendapp/spark MyApp --latest` |
+| Yarn (including Yarn 1) | `yarn create @legendapp/spark MyApp --next` | `yarn create @legendapp/spark MyApp --latest` |
+
+pnpm can drop the creator tag, and Yarn 1 cannot take a tag in `yarn create`.
+The self-contained creator resolves explicit channel flags through npm dist-tags.
+It pins the SDK to its bundled release metadata. If the selected version differs,
+it prints an exact `npx @legendapp/create-spark@<version>` command to run; version
+selection downloads no SDK. `--spark-version <version|tag>` selects another release;
+use only one selection flag. With no flag, the creator uses its own release.
+These commands require the matching creator and release assets to be published.
+
 The app opens in Spark Runner, downloaded from the matching GitHub release.
 Bun is optional. Select another installed package manager with
-`-- --package-manager bun|pnpm|yarn`. Native builds require Xcode and CocoaPods.
+`-- --package-manager bun|pnpm|yarn` with npm, or
+`--package-manager npm|bun|pnpm|yarn` with other managers. Native builds require Xcode and CocoaPods.
 
 Spark is experimental. Windows is a preview without a downloadable Runner.
 See the [documentation](https://legend.so/spark) and

package/dist/index.js

@@ -174418,7 +174418,7 @@ var import_spark_window_options = __toESM(require_window_options(), 1);
 var import_native_patches = __toESM(require_native_patches(), 1);
 var import_config3 = __toESM(require_config(), 1);
 import { createHash as createHash2 } from "node:crypto";
-var VERSION2 = "0.0.1-next.5";
+var VERSION2 = "0.0.1-next.7";
 function digest(value) {
   return createHash2("sha256").update(value).digest("hex");
 }
@@ -174667,14 +174667,64 @@ async function create(root, archiveManifest, platform = hostPlatform(), universa
 
 // packages/create-spark/src/create.ts
 import path13 from "node:path";
+
+// packages/create-spark/src/version.ts
+function creatorArguments(args) {
+  const forwarded = [];
+  let requested;
+  for (let index = 0;index < args.length; index++) {
+    const arg = args[index];
+    if (arg === "--spark-version" || arg.startsWith("--spark-version=") || arg === "--next" || arg === "--latest") {
+      if (requested !== undefined)
+        throw new Error("Choose only one of --next, --latest, or --spark-version.");
+      const value = arg === "--spark-version" ? args[++index] : arg.startsWith("--spark-version=") ? arg.slice(16) : arg.slice(2);
+      if (!value || value.startsWith("-"))
+        throw new Error("--spark-version requires a version or tag");
+      requested = value;
+    } else
+      forwarded.push(arg);
+  }
+  return { requested, forwarded };
+}
+var exactVersion = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/;
+async function resolveCreatorVersion(requested, fetcher = fetch) {
+  if (exactVersion.test(requested))
+    return requested;
+  if (!/^[a-zA-Z][\w.-]*$/.test(requested))
+    throw new Error(`Invalid Spark version or tag: ${requested}`);
+  const response = await fetcher("https://registry.npmjs.org/-/package/@legendapp%2fspark/dist-tags", { signal: AbortSignal.timeout(15000) });
+  if (!response.ok)
+    throw new Error(`Could not resolve Spark tag ${requested}: npm registry HTTP ${response.status}`);
+  const tags = await response.json();
+  const version = tags[requested];
+  if (!version || !exactVersion.test(version))
+    throw new Error(`npm has no exact Spark version for tag ${requested}`);
+  return version;
+}
+async function checkCreatorVersion(requested, forwarded) {
+  const resolved = await resolveCreatorVersion(requested);
+  if (resolved !== VERSION2) {
+    const args = forwarded.filter((arg) => arg !== "--").map((arg) => "'" + arg.replaceAll("'", "'\\''") + "'").join(" ");
+    throw new Error(`Spark ${requested} resolves to ${resolved}, but this creator bundles ${VERSION2}. Run the matching self-contained creator:
+npx @legendapp/create-spark@${resolved} ${args}`);
+  }
+}
+
+// packages/create-spark/src/create.ts
 async function createSpark(args) {
-  const { positionals, values } = cliArguments(["create", ...args]);
+  const { requested, forwarded } = creatorArguments(args);
+  const { positionals, values } = cliArguments(["create", ...forwarded]);
   if (values.help) {
-    console.log("Usage: npm create @legendapp/spark@next MyApp -- [--universal] [--platform macos|windows|ios|android|web] [--example document-editor|notes-lite|music-lite|diff-lite] [--packages manifest.json] [--package-manager npm|pnpm|yarn|bun]");
+    console.log("Usage: npm create @legendapp/spark@next MyApp -- [--next | --latest | --spark-version <version|tag>] [--universal] [--platform macos|windows|ios|android|web] [--example document-editor|notes-lite|music-lite|diff-lite] [--packages manifest.json] [--package-manager npm|pnpm|yarn|bun]");
     return;
   }
   if (values.example && !examples.includes(values.example))
     throw new Error(`Use --example ${examples.join(" | ")}`);
+  if (requested) {
+    if (values.packages)
+      throw new Error("Release version flags cannot be combined with --packages.");
+    await checkCreatorVersion(requested, forwarded);
+  }
   const platform = values.platform ?? hostPlatform();
   process.env.SPARK_PLATFORM = platform;
   try {

package/dist/release.json

@@ -0,0 +1,42 @@
+{
+  "schema": 1,
+  "version": "0.0.1-next.7",
+  "revision": "d750a9463e09c00bf390bb26de207586a3648d40",
+  "packages": {
+    "@react-native-runtimes/core": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/runtimes-985164a87eb0.tgz",
+      "size": 53886,
+      "sha256": "138644fcfaf60b172c9f206c66c6d160515dd8803c70264687d0f503294c9c0b"
+    },
+    "react-native-nitro-modules": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/react-native-nitro-modules-0.37.0-02b4dff54381.tgz",
+      "size": 145600,
+      "sha256": "02b4dff54381bbd4640eb4067e1dc82d7a79ff7e7f83b4357a4265177722d999"
+    },
+    "@op-engineering/op-sqlite": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/op-engineering-op-sqlite-18.2.1-dcc9490310bc.tgz",
+      "size": 112508535,
+      "sha256": "dcc9490310bc74c869ba7cf5e846a8966fab7c3871c4a536482c20be237894fd"
+    },
+    "react-native-webview": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/react-native-webview-16.0.0-b887e540eca8.tgz",
+      "size": 116289,
+      "sha256": "b887e540eca87c6817de6b38c4e8f4076e3a65e0f7fa63f0c5882e1155447a59"
+    },
+    "expo-audio": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/expo-audio-1.1.1-aff5604f2c4c.tgz",
+      "size": 381841,
+      "sha256": "aff5604f2c4cab23299a71e37e802a572b2e66e2e2250b20a261e664d5346693"
+    }
+  },
+  "runners": {
+    "macos-arm64": {
+      "url": "https://github.com/LegendApp/legend-spark/releases/download/v0.0.1-next.7/spark-runner-macos-arm64.zip",
+      "size": 20509043,
+      "sha256": "7441a17362d2be2f78bf5fbb1221b8eb88d988c7f9d877266ab680653f5e65b8",
+      "app": "SparkRunner.app",
+      "teamId": "56DD97VT22",
+      "fingerprint": "a0198a6ade8e3012beb792c8bc3f409e61de34a171035b52a10cc841d766fcb3"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legendapp/create-spark",
-  "version": "0.0.1-next.5",
+  "version": "0.0.1-next.7",
   "description": "Create a Legend Spark app",
   "license": "MIT",
   "type": "module",

package/templates/blank-typescript/package.json

@@ -13,7 +13,7 @@
     "postinstall": "node node_modules/@legendapp/spark/init-template.cjs"
   },
   "dependencies": {
-    "@legendapp/spark": "0.0.1-next.5",
+    "@legendapp/spark": "0.0.1-next.7",
     "expo": "54.0.37",
     "expo-desktop": "1.0.0",
     "expo-desktop-prebuild-config": "1.1.0",

package/templates/universal/package.json

@@ -41,7 +41,7 @@
     "react-native-web": "0.21.0",
     "uniwind": "1.6.3",
     "tailwindcss": "4.2.4",
-    "@legendapp/spark": "0.0.1-next.5"
+    "@legendapp/spark": "0.0.1-next.7"
   },
   "overrides": {
     "@expo/cli": "54.0.27",

package/templates/windows/package.json

@@ -28,7 +28,7 @@
     "react-native-windows": "0.81.35",
     "expo-desktop-modules-core": "54.0.14",
     "expo-desktop-stubs": "54.0.14",
-    "@legendapp/spark": "0.0.1-next.5"
+    "@legendapp/spark": "0.0.1-next.7"
   },
   "overrides": {
     "@expo/cli": "54.0.27",