feat(create-itk-wasm): initial addition

Also make improvements to itk-wasm so the default output will
successfully build and run smoke tests out-of-the-box.

Author: thewtex

examples/mean-squares-versor-registration/package.json

@@ -27,7 +27,7 @@
     "build:micromamba": "itk-wasm pnpm-script build:micromamba",
     "build:python:versionSync": "itk-wasm pnpm-script build:python:versionSync",
     "publish:python": "itk-wasm pnpm-script publish:python",
-    "test:data:download": "dam download test/data test/data.tar.gz bafkreiha6oye3fd5cxfadnua5r2jlkaco2xuyeek454d2ihiffsx7rauqe https://placeholder",
+    "test:data:download": "dam download test/data test/data.tar.gz bafkreicshtctpbmvs4a6jn5pvk2mb6by5vtf2gwx47bulifejtyakhkugy ",
     "test:data:pack": "dam pack test/data test/data.tar.gz",
     "test:python:wasi": "itk-wasm pnpm-script test:python:wasi",
     "test:pyodide:download:emscripten": "itk-wasm pnpm-script test:pyodide:download:emscripten",

packages/core/typescript/create-itk-wasm/.eslintignore

@@ -0,0 +1 @@
+dist

packages/core/typescript/create-itk-wasm/.eslintrc.cjs

@@ -0,0 +1,8 @@
+// eslint-disable-next-line no-undef
+module.exports = {
+  extends: 'standard',
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  root: true,
+  env: { es2022: true }
+}

packages/core/typescript/create-itk-wasm/.gitignore

@@ -0,0 +1,2 @@
+dist/
+test/

packages/core/typescript/create-itk-wasm/README.md

@@ -0,0 +1,3 @@
+# create-itk-wasm
+
+CLI to create a new [ITK-Wasm](https://wasm.itk.org) project or add a pipeline to an existing project.

packages/core/typescript/create-itk-wasm/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "create-itk-wasm",
+  "version": "1.0.1",
+  "description": "CLI to create a new ITK-Wasm project or add a pipeline to an existing project.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "node": "./dist/generate-project.js",
+      "default": "./dist/generate-project.js"
+    }
+  },
+  "bin": {
+    "create-itk-wasm": "./dist/create-itk-wasm.js"
+  },
+  "scripts": {
+    "build": "tsc --pretty",
+    "build:watch": "tsc --pretty --watch",
+    "lint": "prettier --check .",
+    "lint:fix": "prettier --write .",
+    "test": "pnpm test:help && pnpm test:defaultPipeline && pnpm test:imagePipeline && pnpm test:meshPipeline && pnpm test:polyDataPipeline",
+    "test:defaultPipeline": "shx rm -rf test/default && node dist/create-itk-wasm.js -o test/default -n \"default-pipeline\" -a \"Test Monkey\" -d \"Default pipeline description\" --pipeline-name default-pipeline --pipeline-description \"Default pipeline description\" -r \"http://test.repo\" --pipeline-inputs \"default-input:string:A default input\" --pipeline-parameters \"a-double-param:double:A double param\" --pipeline-outputs \"a-json-output:JsonCompatible:A JSON compatible output\" --no-input --build-and-test",
+    "test:imagePipeline": "shx rm -rf test/image && node dist/create-itk-wasm.js -o test/image -n \"image-pipeline\" -a \"Test Monkey\" -d \"Image pipeline description\" --pipeline-name image-pipeline --pipeline-description \"Image pipeline description\" -r \"http://test.repo\" --pipeline-inputs \"input-image:Image:An input image\" --pipeline-parameters \"a-float-param:float:A float param\" --pipeline-outputs \"output-image:Image:An output image\" --pipeline-dispatch Image --no-input --build-and-test",
+    "test:meshPipeline": "shx rm -rf test/mesh && node dist/create-itk-wasm.js -o test/mesh -n \"mesh-pipeline\" -a \"Test Monkey\" -d \"Mesh pipeline description\" --pipeline-name mesh-pipeline --pipeline-description \"Mesh pipeline description\" -r \"http://test.repo\" --pipeline-inputs \"input-mesh:Mesh:An input mesh\" --pipeline-parameters \"a-float-param:float:A float param\" --pipeline-outputs \"output-mesh:Mesh:An output mesh\" --pipeline-dispatch Mesh --no-input --build-and-test",
+    "test:polyDataPipeline": "shx rm -rf test/poly-data && node dist/create-itk-wasm.js -o test/poly-data -n \"poly-data-pipeline\" -a \"Test Monkey\" -d \"PolyData pipeline description\" --pipeline-name poly-data-pipeline --pipeline-description \"PolyData pipeline description\" -r \"http://test.repo\" --pipeline-inputs \"input-poly-data:PolyData:An input poly-data\" --pipeline-parameters \"a-float-param:float:A float param\" --pipeline-outputs \"output-poly-data:PolyData:An output poly-data\" --pipeline-dispatch PolyData --no-input --build-and-test",
+    "test:help": "node dist/create-itk-wasm.js --help"
+  },
+  "homepage": "https://wasm.itk.org/",
+  "bugs": {
+    "url": "https://github.com/InsightSoftwareConsortium/itk-wasm/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/InsightSoftwareConsortium/itk-wasm.git"
+  },
+  "keywords": [
+    "itk",
+    "imaging",
+    "wasm",
+    "webassembly",
+    "wasi",
+    "io",
+    "medical",
+    "scientific"
+  ],
+  "author": "Insight Software Consortium",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@commander-js/extra-typings": "^12.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "figlet": "^1.7.0",
+    "inquirer": "^9.2.14",
+    "node-emoji": "^2.1.3",
+    "validate-npm-package-name": "^5.0.0",
+    "xstate": "^5.6.2"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.5.8",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.16",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "eslint": "^8.56.0",
+    "eslint-config-standard": "^17.1.0",
+    "prettier": "^3.2.5",
+    "prettier-config-standard": "^7.0.0",
+    "shx": "^0.3.4",
+    "typescript": "^5.3.3"
+  },
+  "prettier": "prettier-config-standard"
+}

packages/core/typescript/create-itk-wasm/src/build-and-test.ts

@@ -0,0 +1,20 @@
+import { spawnSync } from 'child_process'
+
+import die from './die.js'
+
+function buildAndTest(directory: string) {
+  const command = ['install', '&&', 'pnpm', 'build', '&&', 'pnpm', 'test']
+  const pnpmProcess = spawnSync('pnpm', command, {
+    env: process.env,
+    stdio: 'inherit',
+    shell: true,
+    cwd: directory
+  })
+  if (pnpmProcess.status !== 0) {
+    console.error(pnpmProcess.error)
+    die(`Failed to build and test in ${directory}`)
+  }
+  process.exit(pnpmProcess.status)
+}
+
+export default buildAndTest

packages/core/typescript/create-itk-wasm/src/camel-case.ts

@@ -0,0 +1,17 @@
+function camelCase(param: string): string {
+  // make any alphabets that follows '-' an uppercase character, and remove the corresponding hyphen
+  let cameledParam = param.replace(/-([a-z])/g, (kk) => {
+    return kk[1].toUpperCase()
+  })
+
+  // remove all non-alphanumeric characters
+  const outParam = cameledParam.replace(/([^0-9a-z])/gi, '')
+
+  // check if resulting string is empty
+  if (outParam === '') {
+    console.error(`Resulting string is empty.`)
+  }
+  return outParam
+}
+
+export default camelCase

packages/core/typescript/create-itk-wasm/src/create-itk-wasm.ts

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+import figlet from 'figlet'
+import chalk from 'chalk'
+import { createActor, waitFor } from 'xstate'
+
+import die from './die.js'
+import ProjectSpec from './project-spec.js'
+import PipelineSpec from './pipeline-spec.js'
+import parseCliArgs from './parse-cli-args.js'
+import generateProject from './generate/project.js'
+import readFilesystemDefaults from './read-filesystem-defaults.js'
+import inquireMachine from './inquire/machine.js'
+import buildAndTest from './build-and-test.js'
+
+async function main() {
+  let pipelines: PipelineSpec[] = []
+
+  let { noInput, doBuildAndTest, project, pipeline } = parseCliArgs()
+  if (pipeline) {
+    pipelines.push(pipeline)
+  }
+
+  project = readFilesystemDefaults(project)
+
+  if (project.name && !project.typescriptPackageName) {
+    project.typescriptPackageName = project.name
+  }
+  if (project.name && !project.pythonPackageName) {
+    project.pythonPackageName = project.name
+  }
+  if (!project.license) {
+    project.license = 'Apache-2.0'
+  }
+
+  if (noInput) {
+    if (pipelines.length === 0) {
+      die('When using --no-input, at least one pipeline must be specified.')
+    }
+    generateProject(project, pipelines, true)
+    if (doBuildAndTest) {
+      buildAndTest(project.directory)
+    }
+    process.exit(0)
+  }
+
+  console.log(
+    chalk.blueBright(figlet.textSync('ITK-Wasm', { horizontalLayout: 'full' }))
+  )
+
+  const inquireActor = createActor(inquireMachine, {
+    input: { project, pipelines }
+  })
+  inquireActor.start()
+  const snapshot = await waitFor(
+    inquireActor,
+    (snapshot) => {
+      const complete = !!snapshot.output
+      return complete
+    },
+    { timeout: 10e8 }
+  )
+  interface Output {
+    project: ProjectSpec
+    pipelines: PipelineSpec[]
+  }
+  const output = snapshot.output as Output
+  project = output.project
+  pipelines = output.pipelines
+
+  generateProject(project, pipelines, true)
+  if (doBuildAndTest) {
+    buildAndTest(project.directory)
+  }
+}
+
+main()
+  .then(() => {
+    process.exit(0)
+  })
+  .catch((error) => {
+    die(error)
+  })

packages/core/typescript/create-itk-wasm/src/die.ts

@@ -0,0 +1,8 @@
+import chalk from 'chalk'
+
+function die(message: string) {
+  console.error(`\n😵  ${chalk.red(message)}`)
+  process.exit(1)
+}
+
+export default die