xs-dev 0.24.2 → 0.24.4

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.
@@ -8,7 +8,7 @@ const command = {
8
8
  run: async ({ parameters, filesystem, build }) => {
9
9
  var _a, _b, _c;
10
10
  const currentPlatform = (0, os_1.type)().toLowerCase();
11
- const { device = currentPlatform, port, example, listExamples = false, listDevices = false, mode = (_a = process.env.NODE_ENV) !== null && _a !== void 0 ? _a : 'development', output = '', deploy = false, config = {}, } = parameters.options;
11
+ const { device = currentPlatform, port, example, listExamples = false, listDevices = false, mode = (_a = process.env.NODE_ENV) !== null && _a !== void 0 ? _a : 'development', output, deploy = false, config = {}, } = parameters.options;
12
12
  const targetPlatform = (_b = devices_1.DEVICE_ALIAS[device]) !== null && _b !== void 0 ? _b : device;
13
13
  const projectPath = filesystem.resolve((_c = parameters.first) !== null && _c !== void 0 ? _c : '.');
14
14
  await build({
@@ -26,4 +26,4 @@ const command = {
26
26
  },
27
27
  };
28
28
  exports.default = command;
29
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29tbWFuZHMvYnVpbGQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFDQSwyQkFBeUM7QUFFekMsdURBQXdEO0FBZ0J4RCxNQUFNLE9BQU8sR0FBaUM7SUFDNUMsSUFBSSxFQUFFLE9BQU87SUFDYixXQUFXLEVBQUUsNENBQTRDO0lBQ3pELEdBQUcsRUFBRSxLQUFLLEVBQUUsRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxFQUFFLEVBQUU7O1FBQy9DLE1BQU0sZUFBZSxHQUFXLElBQUEsU0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7UUFDdEUsTUFBTSxFQUNKLE1BQU0sR0FBRyxlQUFlLEVBQ3hCLElBQUksRUFDSixPQUFPLEVBQ1AsWUFBWSxHQUFHLEtBQUssRUFDcEIsV0FBVyxHQUFHLEtBQUssRUFDbkIsSUFBSSxHQUFHLE1BQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFpQixtQ0FBSSxhQUFhLEVBQ3RELE1BQU0sR0FBRyxFQUFFLEVBQ1gsTUFBTSxHQUFHLEtBQUssRUFDZCxNQUFNLEdBQUcsRUFBRSxHQUNaLEdBQWlCLFVBQVUsQ0FBQyxPQUFPLENBQUE7UUFDcEMsTUFBTSxjQUFjLEdBQVcsTUFBQSxzQkFBWSxDQUFDLE1BQU0sQ0FBQyxtQ0FBSSxNQUFNLENBQUE7UUFDN0QsTUFBTSxXQUFXLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQyxNQUFBLFVBQVUsQ0FBQyxLQUFLLG1DQUFJLEdBQUcsQ0FBQyxDQUFBO1FBRS9ELE1BQU0sS0FBSyxDQUFDO1lBQ1YsSUFBSTtZQUNKLFlBQVk7WUFDWixXQUFXO1lBQ1gsT0FBTztZQUNQLGNBQWM7WUFDZCxXQUFXO1lBQ1gsSUFBSTtZQUNKLFlBQVksRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTTtZQUN0QyxTQUFTLEVBQUUsTUFBTTtZQUNqQixNQUFNO1NBQ1AsQ0FBQyxDQUFBO0lBQ0osQ0FBQztDQUNGLENBQUE7QUFFRCxrQkFBZSxPQUFPLENBQUEifQ==
29
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVpbGQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29tbWFuZHMvYnVpbGQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFDQSwyQkFBeUM7QUFFekMsdURBQXdEO0FBZ0J4RCxNQUFNLE9BQU8sR0FBaUM7SUFDNUMsSUFBSSxFQUFFLE9BQU87SUFDYixXQUFXLEVBQUUsNENBQTRDO0lBQ3pELEdBQUcsRUFBRSxLQUFLLEVBQUUsRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxFQUFFLEVBQUU7O1FBQy9DLE1BQU0sZUFBZSxHQUFXLElBQUEsU0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7UUFDdEUsTUFBTSxFQUNKLE1BQU0sR0FBRyxlQUFlLEVBQ3hCLElBQUksRUFDSixPQUFPLEVBQ1AsWUFBWSxHQUFHLEtBQUssRUFDcEIsV0FBVyxHQUFHLEtBQUssRUFDbkIsSUFBSSxHQUFHLE1BQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxRQUFpQixtQ0FBSSxhQUFhLEVBQ3RELE1BQU0sRUFDTixNQUFNLEdBQUcsS0FBSyxFQUNkLE1BQU0sR0FBRyxFQUFFLEdBQ1osR0FBaUIsVUFBVSxDQUFDLE9BQU8sQ0FBQTtRQUNwQyxNQUFNLGNBQWMsR0FBVyxNQUFBLHNCQUFZLENBQUMsTUFBTSxDQUFDLG1DQUFJLE1BQU0sQ0FBQTtRQUM3RCxNQUFNLFdBQVcsR0FBRyxVQUFVLENBQUMsT0FBTyxDQUFDLE1BQUEsVUFBVSxDQUFDLEtBQUssbUNBQUksR0FBRyxDQUFDLENBQUE7UUFFL0QsTUFBTSxLQUFLLENBQUM7WUFDVixJQUFJO1lBQ0osWUFBWTtZQUNaLFdBQVc7WUFDWCxPQUFPO1lBQ1AsY0FBYztZQUNkLFdBQVc7WUFDWCxJQUFJO1lBQ0osWUFBWSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNO1lBQ3RDLFNBQVMsRUFBRSxNQUFNO1lBQ2pCLE1BQU07U0FDUCxDQUFDLENBQUE7SUFDSixDQUFDO0NBQ0YsQ0FBQTtBQUVELGtCQUFlLE9BQU8sQ0FBQSJ9
@@ -42,8 +42,12 @@ 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 (typeof result.stdout === 'string') {
46
- const localEnv = Object.fromEntries(result.stdout.split('\n').map((field) => field === null || field === void 0 ? void 0 : 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('=')));
47
51
  if ('PATH' in localEnv)
48
52
  process.env = localEnv;
49
53
  }
@@ -54,4 +58,4 @@ async function sourceEnvironment() {
54
58
  }
55
59
  }
56
60
  exports.sourceEnvironment = sourceEnvironment;
57
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhlYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90b29sYm94L3N5c3RlbS9leGVjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFDQUE4QztBQUM5QyxxQ0FBdUM7QUFDdkMsa0RBQXNEO0FBR3RELFNBQVMsYUFBYTtJQUNwQixNQUFNLFlBQVksR0FBRyxnQkFBTSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUNoRCxJQUFJLFlBQVksS0FBSyxTQUFTLEVBQUU7UUFDOUIsZUFBSyxDQUFDLE9BQU8sQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1FBQzVELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUE7S0FDaEI7SUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUE7QUFDekMsQ0FBQztBQUVEOzs7SUFHSTtBQUNHLEtBQUssVUFBVSxZQUFZLENBQ2hDLE9BQWUsRUFDZixVQUFtQyxFQUFFO0lBRXJDLElBQUk7UUFDRixNQUFNLGdCQUFNLENBQUMsSUFBSSxDQUNmLHlDQUF5QyxPQUFPLEVBQUUsRUFDbEQsT0FBTyxDQUNSLENBQUE7UUFDRCxPQUFNO0tBQ1A7SUFBQyxPQUFPLEtBQUssRUFBRTtRQUNkLElBQUksS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsS0FBSyxLQUFLLEVBQUU7WUFDbkQsYUFBYSxFQUFFLENBQUE7U0FDaEI7YUFBTTtZQUNMLE1BQU0sS0FBSyxDQUFBO1NBQ1o7S0FDRjtJQUVELE1BQU0sZ0JBQU0sQ0FBQyxJQUFJLENBQUMsaUNBQWlDLE9BQU8sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFBO0FBQ3hFLENBQUM7QUFuQkQsb0NBbUJDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsaUJBQWlCO0lBQ3JDLE1BQU0sRUFBRSxHQUFHLElBQUEsY0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7SUFFakQsSUFBSSxFQUFFLEtBQUssWUFBWSxFQUFFO1FBQ3ZCLElBQUk7WUFDRixNQUFNLE1BQU0sR0FBRyxNQUFNLGdCQUFNLENBQUMsS0FBSyxDQUFDLFVBQVUsNkJBQWlCLFNBQVMsRUFBRTtnQkFDdEUsS0FBSyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSzthQUN6QixDQUFDLENBQUE7WUFDRixJQUFJLE9BQU8sTUFBTSxDQUFDLE1BQU0sS0FBSyxRQUFRLEVBQUU7Z0JBQ3JDLE1BQU0sUUFBUSxHQUFHLE1BQU0sQ0FBQyxXQUFXLENBQ2pDLE1BQU0sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQWEsRUFBRSxFQUFFLENBQUMsS0FBSyxhQUFMLEtBQUssdUJBQUwsS0FBSyxDQUFFLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUNwRSxDQUFBO2dCQUNELElBQUksTUFBTSxJQUFJLFFBQVE7b0JBQUUsT0FBTyxDQUFDLEdBQUcsR0FBRyxRQUFRLENBQUE7YUFDL0M7U0FDRjtRQUFDLE9BQU8sS0FBSyxFQUFFO1lBQ2QsT0FBTyxDQUFDLElBQUksQ0FBQyw0Q0FBNEMsRUFBRSxLQUFLLENBQUMsQ0FBQTtTQUNsRTtLQUNGO0FBQ0gsQ0FBQztBQWxCRCw4Q0FrQkMifQ==
61
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhlYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy90b29sYm94L3N5c3RlbS9leGVjLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHFDQUE4QztBQUM5QyxxQ0FBdUM7QUFDdkMsa0RBQXNEO0FBR3RELFNBQVMsYUFBYTtJQUNwQixNQUFNLFlBQVksR0FBRyxnQkFBTSxDQUFDLEtBQUssQ0FBQyxhQUFhLENBQUMsQ0FBQTtJQUNoRCxJQUFJLFlBQVksS0FBSyxTQUFTLEVBQUU7UUFDOUIsZUFBSyxDQUFDLE9BQU8sQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFBO1FBQzVELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUE7S0FDaEI7SUFDRCxPQUFPLENBQUMsR0FBRyxDQUFDLFlBQVksR0FBRyxZQUFZLENBQUE7QUFDekMsQ0FBQztBQUVEOzs7SUFHSTtBQUNHLEtBQUssVUFBVSxZQUFZLENBQ2hDLE9BQWUsRUFDZixVQUFtQyxFQUFFO0lBRXJDLElBQUk7UUFDRixNQUFNLGdCQUFNLENBQUMsSUFBSSxDQUNmLHlDQUF5QyxPQUFPLEVBQUUsRUFDbEQsT0FBTyxDQUNSLENBQUE7UUFDRCxPQUFNO0tBQ1A7SUFBQyxPQUFPLEtBQUssRUFBRTtRQUNkLElBQUksS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsS0FBSyxLQUFLLEVBQUU7WUFDbkQsYUFBYSxFQUFFLENBQUE7U0FDaEI7YUFBTTtZQUNMLE1BQU0sS0FBSyxDQUFBO1NBQ1o7S0FDRjtJQUVELE1BQU0sZ0JBQU0sQ0FBQyxJQUFJLENBQUMsaUNBQWlDLE9BQU8sRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFBO0FBQ3hFLENBQUM7QUFuQkQsb0NBbUJDO0FBRUQ7O0dBRUc7QUFDSSxLQUFLLFVBQVUsaUJBQWlCO0lBQ3JDLE1BQU0sRUFBRSxHQUFHLElBQUEsY0FBWSxHQUFFLENBQUMsV0FBVyxFQUFZLENBQUE7SUFFakQsSUFBSSxFQUFFLEtBQUssWUFBWSxFQUFFO1FBQ3ZCLElBQUk7WUFDRixNQUFNLE1BQU0sR0FBRyxNQUFNLGdCQUFNLENBQUMsS0FBSyxDQUFDLFVBQVUsNkJBQWlCLFNBQVMsRUFBRTtnQkFDdEUsS0FBSyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsS0FBSzthQUN6QixDQUFDLENBQUE7WUFDRixJQUNFLE9BQU8sTUFBTSxDQUFDLE1BQU0sS0FBSyxRQUFRO2dCQUNqQyxNQUFNLENBQUMsTUFBTSxZQUFZLE1BQU0sRUFDL0I7Z0JBQ0EsTUFBTSxRQUFRLEdBQUcsTUFBTSxDQUFDLFdBQVcsQ0FDakMsTUFBTSxDQUFDLE1BQU07cUJBQ1YsUUFBUSxFQUFFO3FCQUNWLEtBQUssQ0FBQyxJQUFJLENBQUM7cUJBQ1gsR0FBRyxDQUFDLENBQUMsS0FBYSxFQUFFLEVBQUUsQ0FBQyxLQUFLLGFBQUwsS0FBSyx1QkFBTCxLQUFLLENBQUUsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQzdDLENBQUE7Z0JBQ0QsSUFBSSxNQUFNLElBQUksUUFBUTtvQkFBRSxPQUFPLENBQUMsR0FBRyxHQUFHLFFBQVEsQ0FBQTthQUMvQztTQUNGO1FBQUMsT0FBTyxLQUFLLEVBQUU7WUFDZCxPQUFPLENBQUMsSUFBSSxDQUFDLDRDQUE0QyxFQUFFLEtBQUssQ0FBQyxDQUFBO1NBQ2xFO0tBQ0Y7QUFDSCxDQUFDO0FBeEJELDhDQXdCQyJ9
@@ -49,6 +49,16 @@ Node comes with [npm](https://docs.npmjs.com/cli/v8/commands/npm) as the include
49
49
  - [pnpm](https://pnpm.io/installation)
50
50
  - [yarn](https://yarnpkg.com/)
51
51
 
52
+ ### Troubleshooting
53
+
54
+ If you encounter an `EACCES` error after setting up NodeJS and attempt to install a package, like the following:
55
+
56
+ ```
57
+ Error: EACCES: permission denied, mkdir
58
+ ```
59
+
60
+ Check out the [npm docs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally) to learn about to resolve it: https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally
61
+
52
62
  ## Linux Permissions
53
63
 
54
64
  Setup commands rely on [`ssh-askpass`](https://packages.ubuntu.com/bionic/ssh-askpass) to prompt for permission when installing other tools and dependencies.
@@ -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.2",
3
+ "version": "0.24.4",
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": {