create-vizion-digital-agency 1.0.0

package/README.md

@@ -0,0 +1,10 @@
+# create-vizion-digital-agency
+
+Nieuwe projecten van Vizion Digital Agency.
+
+```bash
+npm create vizion-digital-agency@latest
+```
+
+Dit pakket is alleen de opstarter. De componenten staan in een privé repository van Vizion Digital Agency en worden
+met je eigen Git-toegang opgehaald; zonder toegang tot die repository doet dit pakket niets.

package/index.mjs

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+/**
+ * create-vizion-digital-agency: nieuwe projecten van Vizion Digital Agency.
+ *
+ *   npm create vizion-digital-agency@latest [map]
+ *
+ * Dit is alleen de opstarter en bevat zelf geen componenten. Hij zoekt de nieuwste release van de (privé) repository,
+ * haalt die op met git (met jouw eigen GitHub-toegang) en start daarna cli/run.mjs uit die kopie. Zo werkt iedereen
+ * met een geteste versie, en hoeft dit pakket alleen opnieuw gepubliceerd te worden als dit bestand verandert.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn, spawnSync } from "node:child_process";
+import { parseArgs } from "node:util";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import * as ui from "@clack/prompts";
+
+/** Gelijk houden met package.json (npm test controleert dat). */
+const VERSION = "1.0.0";
+/** Afspraak met cli/run.mjs; alleen ophogen als de aanroep van run() verandert. */
+const CONTRACT = 1;
+const REPOSITORY = "https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency.git";
+
+// ── Kleuren (het logo en de rest van het uiterlijk komen uit de repository: cli/lib/ui.mjs) ──
+const tty = !process.env.NO_COLOR && process.stdout.isTTY;
+const paint = (code) => (text) => (tty ? `\x1b[${code}m${text}\x1b[0m` : text);
+const bold = paint(1);
+const dim = paint(2);
+const red = paint(31);
+
+const HELP = `
+${bold("Vizion Digital Agency")}: nieuw project
+
+  npm create vizion-digital-agency@latest [map]
+
+  [map]               Waar het project komt (standaard: deze map als hij leeg is, anders een nieuwe map)
+  --ref <ref>         Een andere versie gebruiken: een tag (v1.2.0) of branch (main). Standaard: de nieuwste release
+  --answers <bestand> Zonder vragen: alle antwoorden uit een JSON-bestand (voor scripts en tests)
+  --local             Ontwikkelen: de componenten uit de repository waarin deze launcher staat
+  -v, --version       Versie van deze launcher
+  -h, --help          Deze uitleg
+
+  Nodig: Node.js 22 of nieuwer en Git met toegang tot github.com/Vizion-Digital-Agency.
+`;
+
+const { values: options, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    ref: { type: "string" },
+    local: { type: "boolean" },
+    answers: { type: "string" },
+    version: { type: "boolean", short: "v" },
+    help: { type: "boolean", short: "h" },
+  },
+});
+
+if (options.help) {
+  console.log(HELP);
+  process.exit(0);
+}
+if (options.version) {
+  console.log(VERSION);
+  process.exit(0);
+}
+
+const [major] = process.versions.node.split(".").map(Number);
+if (major < 22) {
+  console.error(red(`Node.js 22 of nieuwer is nodig (je hebt ${process.versions.node}). Installeer Node.js 24 LTS.`));
+  process.exit(1);
+}
+
+/** git zonder shell: argumenten (zoals de map) gaan nooit door een shell. */
+const git = (args) =>
+  new Promise((resolve) => {
+    const child = spawn("git", args, { stdio: ["ignore", "pipe", "pipe"] });
+    let output = "";
+    child.stdout.on("data", (chunk) => (output += chunk));
+    child.stderr.on("data", (chunk) => (output += chunk));
+    child.on("error", (error) => resolve({ ok: false, output: error.message }));
+    child.on("close", (code) => resolve({ ok: code === 0, output }));
+  });
+
+/** De nieuwste release (tag vX.Y.Z), of null als er nog geen is. */
+async function latestRelease(repository) {
+  const result = await git(["ls-remote", "--tags", "--refs", repository, "v*"]);
+  if (!result.ok) return { error: result.output.trim() };
+  const versions = [...result.output.matchAll(/refs\/tags\/(v(\d+)\.(\d+)\.(\d+))$/gm)]
+    .map((m) => ({ tag: m[1], parts: [Number(m[2]), Number(m[3]), Number(m[4])] }))
+    .sort((a, b) => b.parts[0] - a.parts[0] || b.parts[1] - a.parts[1] || b.parts[2] - a.parts[2]);
+  return { tag: versions[0]?.tag ?? null };
+}
+
+const accessHint =
+  "Heb je toegang tot github.com/Vizion-Digital-Agency/create-vizion-digital-agency, en is Git bij GitHub ingelogd " +
+  "(bijv. via GitHub Desktop of Git Credential Manager)?";
+
+let sourceRoot;
+let ref = "lokaal";
+let clone = null;
+try {
+  if (options.local) {
+    sourceRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+    if (!fs.existsSync(path.join(sourceRoot, "cli", "run.mjs"))) {
+      ui.cancel("--local werkt alleen vanuit de repository met de componenten.");
+      process.exit(1);
+    }
+  } else {
+    if (spawnSync("git", ["--version"], { stdio: "ignore" }).status !== 0) {
+      ui.cancel("Git is nodig om de componenten op te halen. Installeer Git en probeer het opnieuw.");
+      process.exit(1);
+    }
+    const repository = process.env.VIZION_REPO ?? REPOSITORY;
+    const spinner = ui.spinner();
+    spinner.start("Vizion: nieuwste versie zoeken");
+    if (options.ref) {
+      ref = options.ref;
+    } else {
+      const release = await latestRelease(repository);
+      if (release.error) {
+        spinner.stop("GitHub niet bereikbaar", 1);
+        ui.log.error(release.error);
+        ui.cancel(accessHint);
+        process.exit(1);
+      }
+      ref = release.tag ?? "main";
+    }
+
+    spinner.message(`Componenten ophalen (${ref})`);
+    clone = fs.mkdtempSync(path.join(os.tmpdir(), "vizion-"));
+    const result = await git(["clone", "--depth", "1", "--quiet", "--branch", ref, repository, clone]);
+    if (!result.ok) {
+      spinner.stop("Ophalen mislukt", 1);
+      ui.log.error(result.output.trim());
+      ui.cancel(accessHint);
+      process.exitCode = 1;
+    } else {
+      spinner.stop(`Vizion-componenten opgehaald ${dim(`(${ref})`)}`);
+      sourceRoot = clone;
+    }
+  }
+
+  if (sourceRoot) {
+    const { run } = await import(pathToFileURL(path.join(sourceRoot, "cli", "run.mjs")).href);
+    await run({ sourceRoot, options, positionals, ui, cwd: process.cwd(), launcher: { version: VERSION, contract: CONTRACT, ref } });
+  }
+} finally {
+  if (clone) fs.rmSync(clone, { recursive: true, force: true });
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "create-vizion-digital-agency",
+  "version": "1.0.0",
+  "description": "Nieuwe projecten van Vizion Digital Agency: npm create vizion-digital-agency",
+  "type": "module",
+  "bin": {
+    "create-vizion-digital-agency": "index.mjs"
+  },
+  "files": [
+    "index.mjs"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vizion-Digital-Agency/create-vizion-digital-agency.git",
+    "directory": "packages/create-vizion-digital-agency"
+  },
+  "author": "Vizion Digital Agency",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@clack/prompts": "^1.8.1"
+  }
+}