@shop-on/create-theme 0.0.0-stage → 0.1.0

package/dist/LICENSE.md

@@ -0,0 +1,39 @@
+# Cody Theme Development License
+
+Copyright (c) 2026 Cody LLC. All rights reserved except as granted below.
+
+"The Software" is this package, its source, and its documentation. "The
+Platform" is Cody, the commerce platform operated by Cody LLC.
+
+## 1. Grant
+
+You may use, copy and modify the Software, and distribute modified copies, solely
+to develop, test, and distribute themes, apps and other extensions that run on
+the Platform.
+
+## 2. Restrictions
+
+You may not:
+
+1. use the Software, or anything derived from it, with any commerce platform,
+   storefront or hosting service other than the Platform;
+2. use the Software to build a product that competes with the Platform;
+3. sublicense the Software, or distribute it other than as part of a theme,
+   app or extension for the Platform;
+4. remove or alter this license or any copyright notice in the Software.
+
+## 3. Your work
+
+Themes, apps and extensions you build with the Software are yours. The parts of
+the Software they include stay under this license.
+
+## 4. Termination
+
+This license ends automatically if you break any of its terms. You must then
+stop using the Software and delete your copies of it.
+
+## 5. No warranty
+
+The Software is provided "as is", without warranty of any kind. Cody LLC is not
+liable for any claim, damages or other liability arising from the Software or
+its use.

package/dist/cli.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/cli.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { packageManagerCommands, scaffoldTheme } from "./index.mjs";
+import path from "node:path";
+//#region src/cli.ts
+const USAGE = "usage: npm create @shop-on/theme <dir>";
+const dir = process.argv[2];
+if (dir === "-h" || dir === "--help") {
+	console.log(USAGE);
+	process.exit(0);
+}
+if (!dir || dir.startsWith("-")) {
+	console.error(USAGE);
+	process.exit(1);
+}
+let theme;
+try {
+	theme = scaffoldTheme({ dir });
+} catch (error) {
+	console.error(error instanceof Error ? error.message : error);
+	process.exit(1);
+}
+const commands = packageManagerCommands(process.env.npm_config_user_agent);
+const [install, dev] = [commands.install.join(" "), commands.dev.join(" ")];
+const relative = path.relative(process.cwd(), theme.dir);
+const steps = [
+	...relative ? [`cd ${/\s/.test(relative) ? JSON.stringify(relative) : relative}`] : [],
+	install,
+	"cp .env.example .env   # then fill in your store's storefront credentials",
+	dev
+];
+console.log(`
+Theme scaffolded in ${theme.dir}
+
+Next:
+${steps.map((step, i) => `  ${i + 1}. ${step}`).join("\n")}
+
+Once the Shop-On CLI is published, \`shop-on theme init\` does all this and fills in .env for you.
+`);
+//#endregion
+export {};

package/dist/index.d.mts

@@ -0,0 +1,32 @@
+//#region src/index.d.ts
+/**
+ * `{ [name]: packedName }`: the files `npm pack` leaves out of a tarball, which
+ * `template/` stores renamed and `scaffoldTheme` restores.
+ */
+export declare const PACKED_NAMES: Record<string, string>;
+export type ScaffoldThemeResult = {
+  /** Absolute path of the new theme. */
+  dir: string;
+  /** The `name` written to its `package.json`: `dir`'s basename, slugified. */
+  name: string;
+  /** Every file written, relative to `dir`, `/`-separated, sorted. */
+  files: string[];
+};
+/**
+ * Copies the theme starter into `dir`, creating it if needed, and names the
+ * package after it. Throws if `dir` exists and holds anything but `.git`.
+ * Writes no `.env` and touches no network.
+ */
+export declare function scaffoldTheme({ dir }: {
+  dir: string;
+}): ScaffoldThemeResult;
+/**
+ * The install and dev commands of the package manager that ran this process,
+ * which `npm_config_user_agent` names (e.g. `pnpm/10.33.0 npm/? node/v24.0.0
+ * darwin arm64`). npm when it names none.
+ */
+export declare function packageManagerCommands(userAgent: string | undefined): {
+  install: string[];
+  dev: string[];
+};
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,81 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/index.ts
+/**
+* `{ [name]: packedName }`: the files `npm pack` leaves out of a tarball, which
+* `template/` stores renamed and `scaffoldTheme` restores.
+*/
+const PACKED_NAMES = { ".gitignore": "_gitignore" };
+const RESTORED_NAMES = Object.fromEntries(Object.entries(PACKED_NAMES).map(([name, packed]) => [packed, name]));
+const TEMPLATE = fileURLToPath(new URL("../template", import.meta.url));
+const isEmptyDir = (dir) => fs.statSync(dir).isDirectory() && fs.readdirSync(dir).every((entry) => entry === ".git");
+const toPackageName = (dir) => path.basename(dir).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "shop-on-theme";
+/**
+* Copies the theme starter into `dir`, creating it if needed, and names the
+* package after it. Throws if `dir` exists and holds anything but `.git`.
+* Writes no `.env` and touches no network.
+*/
+function scaffoldTheme({ dir }) {
+	const target = path.resolve(dir);
+	if (fs.existsSync(target) && !fs.statSync(target).isDirectory()) throw new Error(`${target} is a file, not a directory. Pick a new directory.`);
+	if (fs.existsSync(target) && !isEmptyDir(target)) throw new Error(`${target} is not empty. Pick a new directory, or empty this one first.`);
+	if (!fs.existsSync(TEMPLATE)) throw new Error(`${TEMPLATE} is missing. In the repo, run \`pnpm -C packages/create-theme template\`.`);
+	const files = [];
+	for (const entry of fs.readdirSync(TEMPLATE, {
+		recursive: true,
+		withFileTypes: true
+	})) {
+		if (!entry.isFile()) continue;
+		const relativeDir = path.relative(TEMPLATE, entry.parentPath);
+		const file = path.join(relativeDir, RESTORED_NAMES[entry.name] ?? entry.name);
+		fs.mkdirSync(path.join(target, relativeDir), { recursive: true });
+		fs.copyFileSync(path.join(entry.parentPath, entry.name), path.join(target, file));
+		files.push(file.split(path.sep).join("/"));
+	}
+	const name = toPackageName(target);
+	const manifestPath = path.join(target, "package.json");
+	const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+	manifest.name = name;
+	fs.writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+	return {
+		dir: target,
+		name,
+		files: files.sort()
+	};
+}
+/**
+* The install and dev commands of the package manager that ran this process,
+* which `npm_config_user_agent` names (e.g. `pnpm/10.33.0 npm/? node/v24.0.0
+* darwin arm64`). npm when it names none.
+*/
+function packageManagerCommands(userAgent) {
+	switch (userAgent?.split("/")[0]) {
+		case "pnpm": return {
+			install: ["pnpm", "install"],
+			dev: ["pnpm", "dev"]
+		};
+		case "yarn": return {
+			install: ["yarn"],
+			dev: ["yarn", "dev"]
+		};
+		case "bun": return {
+			install: ["bun", "install"],
+			dev: [
+				"bun",
+				"run",
+				"dev"
+			]
+		};
+		default: return {
+			install: ["npm", "install"],
+			dev: [
+				"npm",
+				"run",
+				"dev"
+			]
+		};
+	}
+}
+//#endregion
+export { PACKED_NAMES, packageManagerCommands, scaffoldTheme };

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@shop-on/create-theme",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Scaffolds a Shop-On storefront theme: `npm create @shop-on/theme <dir>`.",
+  "license": "SEE LICENSE IN dist/LICENSE.md",
+  "bin": {
+    "create-theme": "./dist/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@types/node": "26.6.3",
+    "typescript": "7.0.2",
+    "vitest": "5.0.3"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "template": "node scripts/template.mts",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }