arcadible 0.1.0 → 0.1.2

package/src/cli/inspect.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const inspectTool = require("../action/inspect/tool");
+
+// [function]
+
+const main = function (conf) {
+  return inspectTool(conf);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/login.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const loginTool = require("../action/login/tool");
+
+// [function]
+
+const main = function ({ handler, ...conf }) {
+  return loginTool(conf, handler);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/logout.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const logoutTool = require("../action/logout/tool");
+
+// [function]
+
+const main = function (conf) {
+  return logoutTool(conf);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/pack.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const packTool = require("../action/pack/tool");
+
+// [function]
+
+const main = function (conf) {
+  return packTool(conf);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/validate.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const validateTool = require("../action/validate/tool");
+
+// [function]
+
+const main = function (conf) {
+  return validateTool(conf);
+};
+
+// [export]
+
+module.exports = main;

package/src/cli/whoami.js

@@ -0,0 +1,15 @@
+"use strict";
+
+// [import]
+
+const whoamiTool = require("../action/whoami/tool");
+
+// [function]
+
+const main = function ({ handler, ...conf }) {
+  return whoamiTool(conf, handler);
+};
+
+// [export]
+
+module.exports = main;

package/src/config/html.js

@@ -0,0 +1,27 @@
+"use strict";
+
+// [export]
+
+module.exports = {
+  ALLOWED_ATTR: ["href", "target", "rel", "src", "alt", "title"],
+  ALLOWED_TAGS: [
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "hr",
+    "p",
+    "ul",
+    "ol",
+    "li",
+    "pre",
+    "img",
+    "a",
+    "code",
+    "strong",
+    "b",
+    "em",
+    "i",
+    "br",
+  ],
+};

package/src/config/uri.js

@@ -0,0 +1,14 @@
+"use strict";
+
+// [declare]
+
+const SLD = "arcadible";
+
+// [export]
+
+module.exports = {
+  HOST_HTTP_ACCOUNT: `https://account.${SLD}.com`,
+  HOST_HTTP_API: `https://api.${SLD}.com`,
+  HOST_HTTP_DEVELOPER: `https://developer.${SLD}.com`,
+  HOST_HTTP_WWW: `https://${SLD}.com`,
+};

package/src/config/url.js

@@ -0,0 +1,17 @@
+"use strict";
+
+// [import]
+
+const cfguri = require("./uri");
+
+// [declare]
+
+const SLD = "arcadible";
+
+// [export]
+
+module.exports = {
+  GETTING_STARTED: `${cfguri.HOST_HTTP_DEVELOPER}/guides/games/getting-started`,
+  LINK: `${cfguri.HOST_HTTP_ACCOUNT}/link`,
+  MANIFEST: `${cfguri.HOST_HTTP_DEVELOPER}/references/${SLD}-manifest`,
+};

package/src/config/workflow.js

@@ -2,4 +2,9 @@
 
 // [export]
 
-module.exports = {};
+module.exports = {
+  /* eslint-disable camelcase */
+  deploy_dir: ".arcadible-public",
+  skip_build: false,
+  /* eslint-enable camelcase */
+};

package/src/{manifest.js → parser/manifest.js}

@@ -12,6 +12,7 @@ const TOML = require("@iarna/toml");
 // [use]
 
 const join = path.join;
+const pathExists = fs.pathExists;
 const readFile = fs.readFile;
 
 // [declare]
@@ -33,12 +34,10 @@ const parseToml = function (buf) {
 // [function]
 
 const parse = function (root) {
-  return new Promise((resolve, reject) => {
-    readFile(join(root, MANIFEST), "utf8")
-      .then(parseToml)
-      .then(resolve)
-      .catch(reject);
-  });
+  const file = join(root, MANIFEST);
+  return pathExists(file)
+    .then((exists) => (exists ? readFile(file, "utf8") : null))
+    .then((buf) => (buf === null ? {} : parseToml(buf)));
 };
 
 // [export]

package/src/{media.js → parser/media.js}

@@ -10,7 +10,7 @@ const fs = require("fs-extra");
 
 // [import]
 
-const objs = require("./util/objs");
+const objs = require("../util/objs");
 
 // [use]
 

package/src/parser/pkg.js

@@ -0,0 +1,56 @@
+"use strict";
+
+// [import]
+
+const path = require("node:path");
+
+// [import]
+
+const fs = require("fs-extra");
+
+// [use]
+
+const join = path.join;
+const pathExists = fs.pathExists;
+const readFile = fs.readFile;
+
+// [declare]
+
+const PACKAGE = "package.json";
+
+// [function]
+
+const parseJson = function (buf) {
+  try {
+    return JSON.parse(buf);
+  } catch (ex) {
+    throw new Error(`Unable to parse ${PACKAGE}: ${ex.message}`, {
+      cause: ex,
+    });
+  }
+};
+
+// [function]
+
+const extract = function (pkg) {
+  const game = { version: pkg.version || null };
+  return Object.fromEntries(
+    Object.entries({ game }).filter(([, value]) =>
+      Object.values(value).some(Boolean),
+    ),
+  );
+};
+
+// [function]
+
+const parse = function (root) {
+  const file = join(root, PACKAGE);
+  return pathExists(file)
+    .then((exists) => (exists ? readFile(file, "utf8") : null))
+    .then((buf) => (buf === null ? {} : parseJson(buf)))
+    .then((pkg) => (Object.keys(pkg).length ? extract(pkg) : {}));
+};
+
+// [export]
+
+module.exports = { parse };

package/src/parser/project.js

@@ -0,0 +1,59 @@
+"use strict";
+
+// [import]
+
+const cfggame = require("../config/game");
+const cfgworkflow = require("../config/workflow");
+const manifest = require("./manifest");
+const media = require("./media");
+const pkg = require("./pkg");
+const promise = require("../util/promise");
+const readme = require("./readme");
+
+// [function]
+
+const configGame = function (readmeGame, mediaGame, pkgGame, manifestGame) {
+  return {
+    ...cfggame,
+    ...(readmeGame || {}),
+    ...(mediaGame || {}),
+    ...(pkgGame || {}),
+    ...(manifestGame || {}),
+  };
+};
+
+// [function]
+
+const configWorkflow = function (manifestWorkflow) {
+  return {
+    ...cfgworkflow,
+    ...(manifestWorkflow || {}),
+  };
+};
+
+// [function]
+
+const parse = function (root) {
+  const parsers = [
+    () => manifest.parse(root),
+    () => media.parse(root),
+    () => pkg.parse(root),
+    () => readme.parse(root),
+  ];
+  return promise
+    .serial(parsers)
+    .then(([manifestData, mediaData, pkgData, readmeData]) => {
+      const game = configGame(
+        readmeData.game,
+        mediaData.game,
+        pkgData.game,
+        manifestData.game,
+      );
+      const workflow = configWorkflow(manifestData.workflow);
+      return { game, workflow };
+    });
+};
+
+// [export]
+
+module.exports = { parse };

package/src/{readme.js → parser/readme.js}

@@ -10,21 +10,22 @@ const fs = require("fs-extra");
 
 // [import]
 
-const dom = require("./util/dom");
-const MD = require("./util/md");
-const objs = require("./util/objs");
-const strs = require("./util/strs");
+const dom = require("../util/dom");
+const MD = require("../util/md");
+const objs = require("../util/objs");
+const strs = require("../util/strs");
 
 // [use]
 
 const join = path.join;
+const pathExists = fs.pathExists;
 const pruneEmpty = objs.pruneEmpty;
 const readFile = fs.readFile;
 const trimWhitespace = strs.trimWhitespace;
 
 // [declare]
 
-const README = "README.md";
+const README = ["arcadible.md", "README.md"];
 
 // [function]
 
@@ -118,25 +119,34 @@ const extract = function (html) {
 
 // [function]
 
-const parseReadme = function (buf) {
+const parseReadme = function (buf, file) {
   try {
     return extract(MD.parse(buf));
   } catch (ex) {
-    throw new Error(`Unable to parse ${README}: ${ex.message}`, { cause: ex });
+    throw new Error(`Unable to parse ${file}: ${ex.message}`, {
+      cause: ex,
+    });
   }
 };
 
 // [function]
 
+const findReadme = function (root) {
+  return Promise.all(
+    README.map((file) =>
+      pathExists(join(root, file)).then((exists) => (exists ? file : null)),
+    ),
+  ).then((files) => files.find(Boolean) || null);
+};
+
+// [function]
+
 const parse = function (root) {
-  return new Promise((resolve, reject) => {
-    readFile(join(root, README), "utf8")
-      .then(parseReadme)
-      .then(pruneEmpty)
-      .then((game) => ({ game }))
-      .then(resolve)
-      .catch(reject);
-  });
+  return findReadme(root)
+    .then((file) => (file ? readFile(join(root, file), "utf8") : null))
+    .then((buf) => (buf === null ? null : parseReadme(buf)))
+    .then(pruneEmpty)
+    .then((game) => ({ game: game || null }));
 };
 
 // [export]

package/src/prompt/project.js

@@ -0,0 +1,10 @@
+"use strict";
+
+// [export]
+
+module.exports = {
+  input: {
+    default: ".",
+    message: "Project",
+  },
+};

package/src/prompt/starter.js

@@ -0,0 +1,41 @@
+"use strict";
+
+// [declare]
+
+const REPO = "arcadible";
+
+// [export]
+
+module.exports = {
+  select: {
+    choices: [
+      {
+        description: "Blank starter template.",
+        name: "Blank",
+        value: `${REPO}/starter`,
+      },
+      {
+        description: "Three.js starter template.",
+        name: "Three.js",
+        value: `${REPO}/starter-threejs`,
+      },
+      {
+        description: "Phaser starter template.",
+        name: "Phaser",
+        value: `${REPO}/starter-phaser`,
+      },
+      {
+        description: "PixiJS starter template.",
+        name: "PixiJS",
+        value: `${REPO}/starter-pixijs`,
+      },
+      {
+        description: "Babylon.js starter template.",
+        name: "Babylon.js",
+        value: `${REPO}/starter-babylonjs`,
+      },
+    ],
+    default: `${REPO}/starter`,
+    message: "Starter",
+  },
+};

package/src/schema/game.js

@@ -3,23 +3,28 @@
 // [import]
 
 const chalk = require("chalk");
+const semver = require("semver");
 const z = require("zod");
 
 // [import]
 
-const audience = require("../config/audience");
+const cfgaudience = require("../config/audience");
+const cfggenre = require("../config/genre");
+const cfghtml = require("../config/html");
+const cfginput = require("../config/input");
+const cfgorientation = require("../config/orientation");
+const cfgurl = require("../config/url");
+const cfgvisibility = require("../config/visibility");
 const dom = require("../util/dom");
-const genre = require("../config/genre");
-const input = require("../config/input");
-const orientation = require("../config/orientation");
-const visibility = require("../config/visibility");
+
+// [use]
+
+const validSemver = semver.valid;
 
 // [function]
 
 const reference = function (field) {
-  return chalk.cyan.underline(
-    `https://developer.arcadible.com/references/arcadible-manifest#${field}`,
-  );
+  return chalk.cyan.underline(`${cfgurl.MANIFEST}#${field}`);
 };
 
 // [function]
@@ -93,7 +98,7 @@ const zYouTube = function () {
 
 const zAudience = function () {
   // const field = "game.audience";
-  return z.optional(z.enum(audience));
+  return z.optional(z.enum(cfgaudience));
 };
 
 // [function]
@@ -141,7 +146,12 @@ const zDescription = function () {
       .min(1)
       .max(4000)
       .refine(
-        (html) => html === dom.sanitizeAfm(html),
+        (str) =>
+          str ===
+          dom.sanitize(str, {
+            ALLOWED_ATTR: cfghtml.ALLOWED_ATTR,
+            ALLOWED_TAGS: cfghtml.ALLOWED_TAGS,
+          }),
         message(field, "Contains invalid elements."),
       ),
   );
@@ -158,7 +168,7 @@ const zGallery = function () {
 
 const zGenres = function () {
   // const field = "game.genres";
-  return z.optional(z.array(z.enum(genre)).max(3));
+  return z.optional(z.array(z.enum(cfggenre)).max(3));
 };
 
 // [function]
@@ -193,14 +203,14 @@ const zIconVideo = function () {
 
 const zInputs = function () {
   // const field = "game.inputs";
-  return z.optional(z.array(z.enum(input)).max(3));
+  return z.optional(z.array(z.enum(cfginput)).max(3));
 };
 
 // [function]
 
 const zOrientation = function () {
   // const field = "game.orientation";
-  return z.optional(z.enum(orientation));
+  return z.optional(z.enum(cfgorientation));
 };
 
 // [function]
@@ -262,9 +272,21 @@ const zTrailer = function () {
 
 // [function]
 
+const zVersion = function () {
+  const field = "game.version";
+  return z
+    .string()
+    .refine(
+      (value) => validSemver(value) !== null,
+      message(field, "Must be a valid semver."),
+    );
+};
+
+// [function]
+
 const zVisibility = function () {
   // const field = "game.visibility";
-  return z.optional(z.enum(visibility));
+  return z.optional(z.enum(cfgvisibility));
 };
 
 // [function]
@@ -283,7 +305,7 @@ const zWordmarkAnimated = function () {
 
 // [function]
 
-const main = function (root) {
+const main = function (value, { root }) {
   /* eslint-disable camelcase */
   return z.object({
     audience: zAudience(),
@@ -307,6 +329,7 @@ const main = function (root) {
     tagline: zTagline(),
     title: zTitle(),
     trailer: zTrailer(),
+    version: zVersion(),
     visibility: zVisibility(),
     wordmark: zWordmark(root),
     wordmark_animated: zWordmarkAnimated(root),

package/src/schema/workflow.js

@@ -10,6 +10,10 @@ const chalk = require("chalk");
 const fs = require("fs-extra");
 const z = require("zod");
 
+// [import]
+
+const cfgurl = require("../config/url");
+
 // [use]
 
 const isAbsolute = path.isAbsolute;
@@ -24,9 +28,7 @@ const MEDIA = ".arcadible";
 // [function]
 
 const reference = function (field) {
-  return chalk.cyan.underline(
-    `https://developer.arcadible.com/references/arcadible-manifest#${field}`,
-  );
+  return chalk.cyan.underline(`${cfgurl.MANIFEST}#${field}`);
 };
 
 // [function]
@@ -103,10 +105,10 @@ const zSkipBuild = function () {
 
 // [function]
 
-const main = function (root, workflow) {
+const main = function (value, { root }) {
   /* eslint-disable camelcase */
   return z.object({
-    deploy_dir: zDeployDir(root, workflow),
+    deploy_dir: zDeployDir(root, value),
     skip_build: zSkipBuild(),
   });
   /* eslint-enable camelcase */