create-bascik 1.0.0-rc.1

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "create-bascik",
+  "description": "Create a new Bascik project",
+  "version": "1.0.0-rc.1",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bascikdev/bascik.git",
+    "directory": "create"
+  },
+  "license": "MIT",
+  "homepage": "https://bascik.dev",
+  "author": "Collin Thomas",
+  "type": "module",
+  "files": [
+    "assets/",
+    "dist/",
+    "src/",
+    "README.md"
+  ],
+  "bin": "dist/index.js",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "typescript": "^7.0.2",
+    "vite": "^8.1.5",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepare": "mkdir -p assets && ([ -f ../docs/src/pages/assets/SKILL.md ] && cp ../docs/src/pages/assets/SKILL.md assets/SKILL.md || true) && tsc -p tsconfig.build.json",
+    "prepack": "mkdir -p assets && cp ../docs/src/pages/assets/SKILL.md assets/SKILL.md",
+    "typecheck": "tsc --noEmit",
+    "unit": "vitest run",
+    "test": "vitest",
+    "test:ci": "vitest run",
+    "coverage": "vitest run --coverage.enabled && node bin/update-coverage.ts",
+    "cover": "yarn coverage",
+    "update-coverage": "vitest run --coverage.enabled && node bin/update-coverage.ts"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,11 @@
+export interface CliOptions {
+  yesFlag: boolean;
+  noDevFlag: boolean;
+}
+
+export function parseCliOptions(args: string[]): CliOptions {
+  return {
+    yesFlag: args.includes("-y") || args.includes("--yes"),
+    noDevFlag: args.includes("--no-dev"),
+  };
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { parseCliOptions } from "./cli.js";
+import { scaffold, validateProjectName } from "./scaffold.js";
+
+const args = process.argv.slice(2);
+const { yesFlag, noDevFlag } = parseCliOptions(args);
+const nameArg = args.find((a) => !a.startsWith("-"));
+
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+let projectName: string;
+
+if (nameArg) {
+  projectName = nameArg;
+} else {
+  const answer = await rl.question("Project name (bascik-app): ");
+  projectName = answer.trim() || "bascik-app";
+}
+
+const error = validateProjectName(projectName);
+if (error) {
+  rl.close();
+  console.error(`\nError: ${error}\n`);
+  process.exit(1);
+}
+
+console.log(`\nCreating Bascik project "${projectName}"…\n`);
+await scaffold(projectName);
+console.log(`✓ Scaffolded ${projectName}/\n`);
+
+let shouldInstall: boolean;
+let shouldDev: boolean;
+
+if (yesFlag) {
+  shouldInstall = true;
+  shouldDev = !noDevFlag;
+} else {
+  const installAnswer = await rl.question("Install dependencies now? (Y/n) ");
+  shouldInstall = installAnswer.trim().toLowerCase() !== "n";
+  const devAnswer = await rl.question("Start the dev server after install? (Y/n) ");
+  shouldDev = devAnswer.trim().toLowerCase() !== "n";
+}
+
+rl.close();
+
+const projectDir = join(process.cwd(), projectName);
+const npmCmd = process.platform === "win32" ? "npm.cmd" : "npm";
+
+if (shouldInstall) {
+  console.log("\nInstalling dependencies…\n");
+  spawnSync(npmCmd, ["install"], { cwd: projectDir, stdio: "inherit" });
+}
+
+if (shouldDev) {
+  console.log("\nStarting dev server…\n");
+  spawnSync(npmCmd, ["run", "dev"], { cwd: projectDir, stdio: "inherit" });
+  console.log(`\nTo start again:  cd ${projectName} && npm run dev\n`);
+} else {
+  console.log("\nNext steps:\n");
+  if (!shouldInstall) console.log(`  cd ${projectName}`);
+  if (!shouldInstall) console.log("  npm install");
+  console.log("  npm run dev\n");
+}

package/src/scaffold.integration.test.ts

@@ -0,0 +1,210 @@
+/**
+ * scaffold.integration.test.ts
+ *
+ * Real scaffold-to-compiler integration test.
+ *
+ * Boundary tested:
+ * Real filesystem I/O -> `scaffold(projectName, parentDir)` -> Real Bascik CLI child process compilation.
+ *
+ * Collaborators:
+ * - Real filesystem (`mkdtemp`, `scaffold`, `readFile`, `rm`).
+ * - Real Bascik compiler invoked via child process (`node <pkg>/bin/bascik.js --build`).
+ * - Real asset copying, component expansion, build-script execution, and HTML publication.
+ *
+ * Contract asserted:
+ * 1. Default scaffolded site compiles successfully with exit code 0.
+ * 2. Emitted output contains all 4 pages (`index.html`, `about.html`, `contact.html`, `404.html`).
+ * 3. Component expansion occurs (e.g. `<header class="header">`, `<footer class="footer">`, `<my-counter>`).
+ * 4. Build scripts execute at build time (e.g. copyright year in site footer).
+ * 5. Static assets and favicons are preserved and copied to dist/.
+ * 6. Scaffolding copied the real SKILL.md asset into `.github/skills/bascik/SKILL.md` and `.claude/skills/bascik/SKILL.md`.
+ * 7. Negative-control sensitivity: A corrupted scaffolded page (invalid syntax / broken component) is rejected by the compiler.
+ * 8. Execution mode parity: Verified across both default and worker build pipelines.
+ */
+
+import { describe, it, expect, afterEach, beforeAll } from "vitest";
+import { mkdtemp, readFile, writeFile, rm, access } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
+import { scaffold } from "./scaffold.ts";
+
+const execFileAsync = promisify(execFile);
+
+// Resolve package CLI binary path and dist entry point
+const PKG_CLI = resolve(
+  fileURLToPath(import.meta.url),
+  "../../../pkg/bin/bascik.js",
+);
+const PKG_DIST_INDEX = resolve(
+  fileURLToPath(import.meta.url),
+  "../../../pkg/dist/index.js",
+);
+
+const tempDirs: string[] = [];
+
+afterEach(async () => {
+  await Promise.all(
+    tempDirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })),
+  );
+});
+
+async function createTempDir(prefix: string): Promise<string> {
+  const dir = await mkdtemp(join(tmpdir(), `bascik-scaffold-test-${prefix}-`));
+  tempDirs.push(dir);
+  return dir;
+}
+
+interface BuildResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+
+async function runBascikBuild(projectDir: string, extraArgs: string[] = []): Promise<BuildResult> {
+  try {
+    const { stdout, stderr } = await execFileAsync(
+      process.execPath,
+      [PKG_CLI, "--build", ...extraArgs],
+      {
+        cwd: projectDir,
+        encoding: "utf8",
+        env: {
+          ...process.env,
+          NODE_ENV: "production",
+          BASCIK_SITE_URL: "https://example.com",
+        },
+        timeout: 30_000,
+      },
+    );
+    return { stdout, stderr, exitCode: 0 };
+  } catch (err: unknown) {
+    const execErr = err as { stdout?: string; stderr?: string; code?: number };
+    return {
+      stdout: execErr.stdout ?? "",
+      stderr: execErr.stderr ?? "",
+      exitCode: typeof execErr.code === "number" ? execErr.code : 1,
+    };
+  }
+}
+
+describe("scaffold-to-compiler integration", () => {
+  beforeAll(() => {
+    if (!existsSync(PKG_DIST_INDEX)) {
+      throw new Error(
+        `[scaffold.integration.test] Required artifact missing: ${PKG_DIST_INDEX}. ` +
+          "Run `yarn pkg:build` before running create-bascik integration tests.",
+      );
+    }
+  });
+
+  it("scaffolds and compiles a new project with real compiler and full artifact verification", async () => {
+    const parentDir = await createTempDir("default");
+    const projectName = "test-site";
+    const projectDir = join(parentDir, projectName);
+
+    // 1. Run real scaffold
+    await scaffold(projectName, parentDir);
+
+    // Verify SKILL.md was copied from real assets
+    const githubSkill = await readFile(join(projectDir, ".github/skills/bascik/SKILL.md"), "utf8");
+    const claudeSkill = await readFile(join(projectDir, ".claude/skills/bascik/SKILL.md"), "utf8");
+    expect(githubSkill.length).toBeGreaterThan(100);
+    expect(claudeSkill).toBe(githubSkill);
+
+    // 2. Compile via real Bascik CLI child process
+    const buildResult = await runBascikBuild(projectDir);
+    expect(buildResult.exitCode, `Build failed with stderr: ${buildResult.stderr}`).toBe(0);
+    expect(buildResult.stdout).toContain("Build complete");
+
+    const distDir = join(projectDir, "dist");
+
+    // 3. Verify all 4 expected pages are emitted
+    const indexHtml = await readFile(join(distDir, "index.html"), "utf8");
+    const aboutHtml = await readFile(join(distDir, "about.html"), "utf8");
+    const contactHtml = await readFile(join(distDir, "contact.html"), "utf8");
+    const notFoundHtml = await readFile(join(distDir, "404.html"), "utf8");
+
+    expect(indexHtml).toContain("<!DOCTYPE html>");
+    expect(aboutHtml).toContain("<!DOCTYPE html>");
+    expect(contactHtml).toContain("<!DOCTYPE html>");
+    expect(notFoundHtml).toContain("<!DOCTYPE html>");
+
+    // 4. Verify component expansion and props
+    // site-header expands to <header with brand prop or site name
+    expect(indexHtml).toContain("<header");
+    expect(indexHtml).toContain("test-site");
+    // my-counter expanded to counter button/UI
+    expect(indexHtml).toContain("data-testid=\"counter-inc\"");
+    expect(indexHtml).toContain("data-testid=\"counter-dec\"");
+
+    // 5. Verify build script executed in site-footer (current year)
+    const currentYear = String(new Date().getFullYear());
+    expect(indexHtml).toContain(`&copy; ${currentYear}`);
+    expect(aboutHtml).toContain(`&copy; ${currentYear}`);
+
+    // 6. Verify representative assets copied to dist
+    await expect(access(join(distDir, "favicon.ico"))).resolves.toBeUndefined();
+    await expect(access(join(distDir, "assets/favicon.svg"))).resolves.toBeUndefined();
+    await expect(access(join(distDir, "assets/favicon-32x32.png"))).resolves.toBeUndefined();
+    await expect(access(join(distDir, "assets/apple-touch-icon.png"))).resolves.toBeUndefined();
+    await expect(access(join(distDir, "css/styles.css"))).resolves.toBeUndefined();
+  }, 45_000);
+
+  it("compiles scaffolded project with workers enabled in config", async () => {
+    const parentDir = await createTempDir("workers");
+    const projectName = "worker-site";
+    const projectDir = join(parentDir, projectName);
+
+    await scaffold(projectName, parentDir);
+
+    // Add workers config to bascik.config.js
+    await writeFile(
+      join(projectDir, "bascik.config.js"),
+      `export default {
+  pipeline: { workers: true }
+};
+`,
+      "utf8",
+    );
+
+    const buildResult = await runBascikBuild(projectDir);
+    expect(buildResult.exitCode, `Worker build failed with stderr: ${buildResult.stderr}`).toBe(0);
+    expect(buildResult.stdout).toContain("Build complete");
+
+    const indexHtml = await readFile(join(projectDir, "dist/index.html"), "utf8");
+    const currentYear = String(new Date().getFullYear());
+    expect(indexHtml).toContain("<header");
+    expect(indexHtml).toContain(`&copy; ${currentYear}`);
+  }, 45_000);
+
+  it("negative control: rejects compilation when a required page contains invalid build-script syntax", async () => {
+    const parentDir = await createTempDir("negative-control");
+    const projectName = "corrupt-site";
+    const projectDir = join(parentDir, projectName);
+
+    await scaffold(projectName, parentDir);
+
+    // Inject deliberate build-script syntax error into index.html
+    const corruptPage = `<!DOCTYPE html>
+<html>
+<head><title>Corrupt</title></head>
+<body>
+  <script data-bascik-build>
+    // Deliberate syntax error that fails build-script execution
+    const invalid = (;;
+  </script>
+</body>
+</html>`;
+    await writeFile(join(projectDir, "src/pages/index.html"), corruptPage, "utf8");
+
+    const buildResult = await runBascikBuild(projectDir);
+    expect(buildResult.exitCode).not.toBe(0);
+    // Verifier rejected the corrupted page
+    const combinedOutput = `${buildResult.stdout}\n${buildResult.stderr}`;
+    expect(combinedOutput.toLowerCase()).toMatch(/error|failed|syntaxerror/);
+  }, 45_000);
+});