xs-dev 0.24.1 → 0.24.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -42,8 +42,14 @@ async function sourceEnvironment() {
42
42
  const result = await gluegun_1.system.spawn(`source ${constants_1.EXPORTS_FILE_PATH} && env`, {
43
43
  shell: process.env.SHELL,
44
44
  });
45
- if (result.stdout !== null) {
46
- process.env = Object.fromEntries(result.stdout.split('\n').map((field) => field.split('=')));
45
+ if (typeof result.stdout === 'string' ||
46
+ result.stdout instanceof Buffer) {
47
+ const localEnv = Object.fromEntries(result.stdout
48
+ .toString()
49
+ .split('\n')
50
+ .map((field) => field === null || field === void 0 ? void 0 : field.split('=')));
51
+ if ('PATH' in localEnv)
52
+ process.env = localEnv;
47
53
  }
48
54
  }
49
55
  catch (error) {
@@ -52,4 +58,4 @@ async function sourceEnvironment() {
52
58
  }
53
59
  }
54
60
  exports.sourceEnvironment = sourceEnvironment;
55
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhlYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90b29sYm94L3N5c3RlbS9leGVjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFDQUE4QztBQUM5QyxxQ0FBdUM7QUFDdkMsa0RBQXNEO0FBR3RELFNBQVMsYUFBYTtJQUNwQixNQUFNLFlBQVksR0FBRyxnQkFBTSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUNoRCxJQUFJLFlBQVksS0FBSyxTQUFTLEVBQUU7UUFDOUIsZUFBSyxDQUFDLE9BQU8sQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1FBQzVELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUE7S0FDaEI7SUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUE7QUFDekMsQ0FBQztBQUVEOzs7SUFHSTtBQUNHLEtBQUssVUFBVSxZQUFZLENBQ2hDLE9BQWUsRUFDZixVQUFtQyxFQUFFO0lBRXJDLElBQUk7UUFDRixNQUFNLGdCQUFNLENBQUMsSUFBSSxDQUNmLHlDQUF5QyxPQUFPLEVBQUUsRUFDbEQsT0FBTyxDQUNSLENBQUE7UUFDRCxPQUFNO0tBQ1A7SUFBQyxPQUFPLEtBQUssRUFBRTtRQUNkLElBQUksS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsS0FBSyxLQUFLLEVBQUU7WUFDbkQsYUFBYSxFQUFFLENBQUE7U0FDaEI7YUFBTTtZQUNMLE1BQU0sS0FBSyxDQUFBO1NBQ1o7S0FDRjtJQUVELE1BQU0sZ0JBQU0sQ0FBQyxJQUFJLENBQUMsaUNBQWlDLE9BQU8sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFBO0FBQ3hFLENBQUM7QUFuQkQsb0NBbUJDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsaUJBQWlCO0lBQ3JDLE1BQU0sRUFBRSxHQUFHLElBQUEsY0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7SUFFakQsSUFBSSxFQUFFLEtBQUssWUFBWSxFQUFFO1FBQ3ZCLElBQUk7WUFDRixNQUFNLE1BQU0sR0FBRyxNQUFNLGdCQUFNLENBQUMsS0FBSyxDQUFDLFVBQVUsNkJBQWlCLFNBQVMsRUFBRTtnQkFDdEUsS0FBSyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSzthQUN6QixDQUFDLENBQUE7WUFDRixJQUFJLE1BQU0sQ0FBQyxNQUFNLEtBQUssSUFBSSxFQUFFO2dCQUMxQixPQUFPLENBQUMsR0FBRyxHQUFHLE1BQU0sQ0FBQyxXQUFXLENBQzlCLE1BQU0sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQWEsRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUNuRSxDQUFBO2FBQ0Y7U0FDRjtRQUFDLE9BQU8sS0FBSyxFQUFFO1lBQ2QsT0FBTyxDQUFDLElBQUksQ0FBQyw0Q0FBNEMsRUFBRSxLQUFLLENBQUMsQ0FBQTtTQUNsRTtLQUNGO0FBQ0gsQ0FBQztBQWpCRCw4Q0FpQkMifQ==
61
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhlYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90b29sYm94L3N5c3RlbS9leGVjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFDQUE4QztBQUM5QyxxQ0FBdUM7QUFDdkMsa0RBQXNEO0FBR3RELFNBQVMsYUFBYTtJQUNwQixNQUFNLFlBQVksR0FBRyxnQkFBTSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUNoRCxJQUFJLFlBQVksS0FBSyxTQUFTLEVBQUU7UUFDOUIsZUFBSyxDQUFDLE9BQU8sQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1FBQzVELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUE7S0FDaEI7SUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUE7QUFDekMsQ0FBQztBQUVEOzs7SUFHSTtBQUNHLEtBQUssVUFBVSxZQUFZLENBQ2hDLE9BQWUsRUFDZixVQUFtQyxFQUFFO0lBRXJDLElBQUk7UUFDRixNQUFNLGdCQUFNLENBQUMsSUFBSSxDQUNmLHlDQUF5QyxPQUFPLEVBQUUsRUFDbEQsT0FBTyxDQUNSLENBQUE7UUFDRCxPQUFNO0tBQ1A7SUFBQyxPQUFPLEtBQUssRUFBRTtRQUNkLElBQUksS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsS0FBSyxLQUFLLEVBQUU7WUFDbkQsYUFBYSxFQUFFLENBQUE7U0FDaEI7YUFBTTtZQUNMLE1BQU0sS0FBSyxDQUFBO1NBQ1o7S0FDRjtJQUVELE1BQU0sZ0JBQU0sQ0FBQyxJQUFJLENBQUMsaUNBQWlDLE9BQU8sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFBO0FBQ3hFLENBQUM7QUFuQkQsb0NBbUJDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsaUJBQWlCO0lBQ3JDLE1BQU0sRUFBRSxHQUFHLElBQUEsY0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7SUFFakQsSUFBSSxFQUFFLEtBQUssWUFBWSxFQUFFO1FBQ3ZCLElBQUk7WUFDRixNQUFNLE1BQU0sR0FBRyxNQUFNLGdCQUFNLENBQUMsS0FBSyxDQUFDLFVBQVUsNkJBQWlCLFNBQVMsRUFBRTtnQkFDdEUsS0FBSyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSzthQUN6QixDQUFDLENBQUE7WUFDRixJQUNFLE9BQU8sTUFBTSxDQUFDLE1BQU0sS0FBSyxRQUFRO2dCQUNqQyxNQUFNLENBQUMsTUFBTSxZQUFZLE1BQU0sRUFDL0I7Z0JBQ0EsTUFBTSxRQUFRLEdBQUcsTUFBTSxDQUFDLFdBQVcsQ0FDakMsTUFBTSxDQUFDLE1BQU07cUJBQ1YsUUFBUSxFQUFFO3FCQUNWLEtBQUssQ0FBQyxJQUFJLENBQUM7cUJBQ1gsR0FBRyxDQUFDLENBQUMsS0FBYSxFQUFFLEVBQUUsQ0FBQyxLQUFLLGFBQUwsS0FBSyx1QkFBTCxLQUFLLENBQUUsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQzdDLENBQUE7Z0JBQ0QsSUFBSSxNQUFNLElBQUksUUFBUTtvQkFBRSxPQUFPLENBQUMsR0FBRyxHQUFHLFFBQVEsQ0FBQTthQUMvQztTQUNGO1FBQUMsT0FBTyxLQUFLLEVBQUU7WUFDZCxPQUFPLENBQUMsSUFBSSxDQUFDLDRDQUE0QyxFQUFFLEtBQUssQ0FBQyxDQUFBO1NBQ2xFO0tBQ0Y7QUFDSCxDQUFDO0FBeEJELDhDQXdCQyJ9
@@ -60,3 +60,23 @@ This will keep running until the `Ctrl+C` keys are entered in the terminal sessi
60
60
 
61
61
  Use the `--list-examples` flag with the `run` command to search the extensive list of available examples to run in the simulator: `xs-dev run --list-examples`
62
62
 
63
+ ## Troubleshooting
64
+
65
+ When attempting to run the Hello World example, if you continually see the following error (even after starting a new terminal session):
66
+
67
+ ```
68
+ Moddable tooling required. Run 'xs-dev setup --device <computer os here>' before trying again.
69
+ ```
70
+
71
+ There may be an issue with the terminal shell or command prompt using the correct [environment configuration](/xs-dev/en/features/setup#overview) for xs-dev.
72
+
73
+ - [Learn about Terminal profiles on MacOS](https://support.apple.com/guide/terminal/default-startup-terminal-window-profiles-trml5856b1f2/mac)
74
+ - [Learn about shell initialization files and user profiles on Linux](https://www.tecmint.com/understanding-shell-initialization-files-and-user-profiles-linux/)
75
+ - [Learn about Windows Terminal startup settings](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/startup)
76
+
77
+ On "Unix-like" environments (MacOS, Linux), the `env` command should contain a reference to the `MODDABLE` environment variable:
78
+
79
+ ```
80
+ env | grep MODDABLE
81
+ ```
82
+ The above command should return something like `MODDABLE=/Users/<username>/.local/share/moddable` to indicate where the Moddable SDK has been installed in the filesystem.
@@ -30,6 +30,10 @@ The Moddable SDK and associated dev board tooling is incredibly empowering for e
30
30
  - [-] Windows (currently in beta)
31
31
  - [X] Linux
32
32
 
33
+ **Check out the getting started video from the Moddable team**
34
+
35
+ <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/1gxFWBnDl18" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
36
+
33
37
  ## Requirements
34
38
 
35
39
  [Node.js >= v14](https://nodejs.org/en/)
@@ -69,3 +73,4 @@ pnpm update -g xs-dev
69
73
  ```
70
74
  yarn global upgrade xs-dev
71
75
  ```
76
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xs-dev",
3
- "version": "0.24.1",
3
+ "version": "0.24.3",
4
4
  "description": "CLI for automating the setup and usage of Moddable XS tools",
5
5
  "types": "build/types/types.d.ts",
6
6
  "bin": {