create-loom 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Matt Kantor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+import * as JSONC from 'comment-json';
+import nodeChildProcess from 'node:child_process';
+import { cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import * as nodePath from 'node:path';
+import { parseArgs } from 'node:util';
+const templateDirectory = `${import.meta.dirname}/../template`;
+// This is overkill for now, but reserves space for future options (because
+// `create-loom --foo` is an error).
+const { positionals: cliArgs } = parseArgs({
+    args: process.argv.slice(2), // remove `execPath` and `filename`
+    strict: true,
+    allowPositionals: true,
+});
+if (cliArgs[0] === undefined) {
+    throw new Error('Missing required path argument');
+}
+const path = nodePath.resolve(process.cwd(), cliArgs[0]);
+/**
+ * Create and move to the project directory.
+ */
+await mkdir(path, { recursive: true });
+process.chdir(path);
+/**
+ * Create `package.json`.
+ */
+nodeChildProcess.execSync('npm init --yes');
+/**
+ * Add dependencies.
+ */
+nodeChildProcess.execSync('npm install --save-dev typescript @types/node');
+nodeChildProcess.execSync('npm install @superhighway/silk @superhighway/loom');
+/**
+ * Copy `src`, `.gitignore`, etc to the project from the template directory.
+ */
+await cp(templateDirectory, path, { recursive: true });
+/**
+ * Create `tsconfig.json`.
+ */
+nodeChildProcess.execSync('tsc --init');
+const tsConfigSource = (await readFile(`${path}/tsconfig.json`, {
+    encoding: 'utf-8',
+}))
+    // Clean up some comments that will be irrelevant after config manipulation:
+    .replace('// "outDir": "./dist",\n', '')
+    .replace(/\/\/ For nodejs:\n\s*\/\/ "lib": \["esnext"\],\n\s*\/\/ "types": \["node"\],\n\s*\/\/ and npm install -D @types\/node\n/, '');
+const tsConfig = JSONC.parse(tsConfigSource);
+if (typeof tsConfig !== 'object' ||
+    tsConfig === null ||
+    !('compilerOptions' in tsConfig)) {
+    throw new Error('TypeScript config was not an object with a `compilerOptions` property');
+}
+const compilerOptions = tsConfig['compilerOptions'];
+if (typeof compilerOptions !== 'object' || compilerOptions === null) {
+    throw new Error('TypeScript config `compilerOptions` was not an object');
+}
+// Note this is still a reference to the property of `tsConfig`.
+const assignableCompilerOptions = compilerOptions;
+// `tsc --init` includes `jsx`, but it's nice to keep all `jsx*` properties
+// adjacent, so delete and create a new property of the same name rather than
+// updating the extant one.
+delete assignableCompilerOptions.jsx;
+assignableCompilerOptions.jsx = 'react';
+assignableCompilerOptions.jsxFactory = 'createElement';
+assignableCompilerOptions.jsxFragmentFactory = 'createElement';
+assignableCompilerOptions.types = ['node'];
+assignableCompilerOptions.outDir = 'dist';
+const updatedTSConfigSource = JSONC.stringify(tsConfig, null, 2);
+await writeFile(`${path}/tsconfig.json`, updatedTSConfigSource);
+/**
+ * Edit `package.json` to add scripts and other necessary properties.
+ */
+const scripts = {
+    build: 'npm run compile; npm run copy-non-typescript-files',
+    clean: 'rm -rf dist* *.tsbuildinfo',
+    compile: 'tsc --build',
+    'copy-non-typescript-files': './copy-non-typescript-files',
+    start: 'npm run clean && npm run build; node .',
+};
+const packageManifestPath = `${path}/package.json`;
+const packageManifest = (await import(packageManifestPath, {
+    with: { type: 'json' },
+})).default;
+packageManifest.scripts = scripts;
+packageManifest.main = 'dist/index.js';
+packageManifest.type = 'module';
+await writeFile(packageManifestPath, `${JSON.stringify(packageManifest, null, 2)}\n`);

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "create-loom",
+  "version": "0.0.1",
+  "bin": "dist/index.js",
+  "devDependencies": {
+    "@types/node": "^24.8.1",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist/*",
+    "template/*"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "repository": "github:mkantor/create-loom",
+  "scripts": {
+    "build": "tsc --build tsconfig.main.json",
+    "build:tests": "tsc --project tsconfig.main.json --outDir dist-test --declarationDir dist && tsc --build tsconfig.test.json",
+    "clean": "rm -rf dist* *.tsbuildinfo",
+    "start": "npm run clean && npm run build && node .",
+    "test": "npm run build:tests && cd dist-test && node --test"
+  },
+  "type": "module",
+  "dependencies": {
+    "comment-json": "^4.4.1"
+  }
+}

package/template/copy-non-typescript-files

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+
+root_dir="src"
+out_dir="dist"
+
+find "$root_dir" \
+  \( -type f -or -type l \) \
+  -and \
+  \( -not -name '*.tsx' -and -not -name '*.ts' \) \
+  -exec sh \
+  -c '
+    mkdir -p "$(
+      dirname "'$out_dir'/$(echo $1 | sed -e s#^'$root_dir'/##)"
+    )"
+    cp -R $1 "'$out_dir'/$(echo $1 | sed -e s#^'$root_dir'/##)"
+  ' shell {} \;

package/template/src/index.ts

@@ -0,0 +1,9 @@
+import { createServer } from '@superhighway/loom'
+
+const port = 80
+
+const server = createServer({
+  publicDirectory: `${import.meta.dirname}/public`,
+})
+await server.listen(port)
+console.log(`Server is listening on port ${port}…`)

package/template/src/public/style.css

@@ -0,0 +1,6 @@
+html {
+  font-size: xx-large;
+  display: grid;
+  height: 100%;
+  place-items: center;
+}

package/template/src/public/{error}.tsx

@@ -0,0 +1,12 @@
+import { page } from '@superhighway/loom'
+import { createElement } from '@superhighway/silk'
+
+export default page((request, { status }) => (
+  <html lang="en">
+    <head>
+      <title>Error</title>
+      <link rel="stylesheet" href="style.css" />
+    </head>
+    <body>Something went wrong.</body>
+  </html>
+))

package/template/src/public/{page}.tsx

@@ -0,0 +1,12 @@
+import { page } from '@superhighway/loom'
+import { createElement } from '@superhighway/silk'
+
+export default page(request => (
+  <html lang="en">
+    <head>
+      <title>Greeting</title>
+      <link rel="stylesheet" href="style.css" />
+    </head>
+    <body>Hello, world!</body>
+  </html>
+))