@doikayt/typescript-build-config 0.1.32 → 0.1.37

package/README.md

@@ -50,7 +50,7 @@ via the pipeline files it installs into each consumer repo and the canonical rel
 These steps set up — in a fresh "new-developer" environment — a local git repo
 with a skeleton demo app plus all the standard Doikayt build configuration:
 tooling that auto-documents the code in the repo and lets it be pushed to
-GitHub, built on GitHub's CI servers, and (for a library) published to npm. Steps
+Codeberg, built by Woodpecker CI, and (for a library) published to npm. Steps
 are minimal here — each links to the section that explains _what_ and _why_.
 
 ### 1. One-time machine setup (once per machine)
@@ -59,13 +59,34 @@ Clone this base repo and install the shared team
 [shell aliases](#team-shell-aliases). This only sets up the aliases
 (`dk-scaffold`, `mkrepo`); it does **not** configure any project:
 
+🛑 **STOP here if you are a contributor/maintainer of `typescript-build-config` itself** If you intend to
+push commits back to *this* repo, you're in the wrong place — the clone below is
+HTTPS, read-only for this repo. Start here instead: [For Maintainers](#for-maintainers).
+
 ```bash
-git clone https://github.com/doikayt/typescript-build-config.git   # HTTPS: no SSH key needed
+git clone https://codeberg.org/doikayt/typescript-build-config.git   # HTTPS: no SSH key needed
+#
+## Alternative using ssh key:    git clone ssh://git@codeberg.org/doikayt/typescript-build-config.git
+#
+#
+#
 cd typescript-build-config
 ./assets/shell/install.sh   # adds `source assets/shell/aliases.sh` to your rc (idempotent)
-exec $SHELL                 # reload
+exec $SHELL                 # replaces this shell with a fresh one that reloads your rc
 ```
 
+The aliases are now active in this shell. Run `tools-help` to confirm — it prints every
+command you now have available (`dk-scaffold`, `mkrepo`, and more) with a one-line
+summary of what each does. From here, go to
+[2. Create a new project](#2-create-a-new-project-repeatable) below.
+
+**Re-running this after `aliases.sh` changed?** Always use `exec $SHELL` (a fresh
+shell), not `source assets/shell/aliases.sh` in your existing terminal. If a function
+it defines shares a name with something your shell already has loaded (an old alias
+from a previous version, for instance), sourcing directly can fail with a confusing
+`syntax error near unexpected token`. A fresh shell never had the stale definition to
+begin with.
+
 ### 2. Create a new project (repeatable)
 
 The two paths below are **alternatives that reach the same result** — a project
@@ -74,7 +95,7 @@ wired to this base package.
 #### dk-scaffold
 
 `dk-scaffold` is the one-command wrapper that also (optionally) creates the
-GitHub repo and pushes it. Just run it with a first argument naming your project
+Codeberg repo and pushes it. Just run it with a first argument naming your project
 and a second indicating `lib` (a published library) or `app` (a standalone
 app/utility, the default) — see [library vs app](#usage) and
 [Packaging concepts](docs/packaging-concepts.md):
@@ -83,6 +104,16 @@ app/utility, the default) — see [library vs app](#usage) and
 dk-scaffold my-project lib
 ```
 
+**Where the project lands.** `dk-scaffold <name>` creates a `<name>/` subdirectory in the
+directory you ran it from (for example `~/projects/my-project/`) and leaves your shell
+inside it. Two variants scaffold in place instead of creating a subdirectory:
+
+- run it from inside an empty directory that is already named `<name>`
+- pass `.` as the name, which uses the current directory's name as the project name
+
+`dk-scaffold` will look like it is prompting you, but just wait a moment: the script
+fills in the appropriate answers itself. It prints a note saying so; pass `-q` to hide it.
+
 #### Run dk-scaffold's steps individually
 
 The steps below mirror the work `dk-scaffold` does under the hood — either for a
@@ -105,8 +136,8 @@ throwaway **app** (nothing publishes) unless noted. Do the one-time
 [machine setup](#1-one-time-machine-setup-once-per-machine) first so `dk-scaffold`
 is on your PATH.
 
-**Level 0 — local (no external GitHub/npm accounts needed).** Scaffold and run
-the same gate CI runs — no GitHub repo, no push:
+**Level 0 — local (no external Codeberg/npm accounts needed).** Scaffold and run
+the same gate CI runs — no Codeberg repo, no push:
 
 ```bash
 dk-scaffold my-demo --local
@@ -118,20 +149,24 @@ declarations, and `update-all-format` fill the README's TOC + UML markers
 (mermaid **source** — rendered at Level 1). `npm publish --dry-run` **refuses** —
 proof the app archetype never publishes.
 
-**Level 1 — push to your own GitHub.** Bring a GitHub account and the `gh` CLI.
-Sign in, point the wrapper at your account, and drop `--local`:
+The project is created in `./my-demo/` (a subdirectory of wherever you ran the command),
+and your shell's CWD (current working directory) gets set to the root of this new project.
+This means you can run `npm test` or `npm run build` right away.
+
+**Level 1 — push to your own Codeberg.** Bring a Codeberg account and an API token.
+Export the token, point the wrapper at your account, and drop `--local`:
 
 ```bash
-gh auth login                                # one-time: sign in to GitHub
-export REPO_OWNER=<your-github-username>      # target owner for the repo
-dk-scaffold my-demo                          # app (private) — no npm creds
+export CODEBERG_TOKEN=<your-codeberg-token>   # repository-creation token
+export REPO_OWNER=<your-codeberg-org>        # target owner for the repo
+dk-scaffold my-demo                          # app (public repo) — no npm creds
 ```
 
 Now it creates the repo and pushes — and you see what Level 0 couldn't: the
 **mermaid diagrams rendered** (example
 [here](https://github.com/doikayt/build-tools/blob/main/javascript/tooling-core/README.md#package-structure))
-and the **CI job go green** in Actions (example:
-[this project's runs](https://github.com/doikayt/typescript-build-config/actions)).
+and the **CI job goes green** in Woodpecker CI (example:
+[this project's runs](https://ci.codeberg.org/repos/doikayt/typescript-build-config)).
 Push a follow-up **`feat:`** commit and the **release job** version-bumps + tags —
 nothing published (app). (The initial `chore: scaffold` push releases nothing;
 `feat:` / `fix:` triggers it.)
@@ -139,14 +174,14 @@ nothing published (app). (The initial `chore: scaffold` push releases nothing;
 
 The screen cast below shows the process for Level 1. Note:
 
-- When we log in to our test account (associated with a dummy GitHub account,
+- When we log in to our test account (associated with a dummy Codeberg account,
   not doikayt) we see:
   - no repos initially
   - no doikayt aliases registered in `.bashrc`
-- After we run `dk-scaffold demo`, we need to input 'y' to install, then we see:
+- After we run `dk-scaffold demo`, the install proceeds automatically, then we see:
   - lots of output showing the project being configured and built
-  - a push to GitHub
-  - a build and release triggered on GitHub
+  - a push to Codeberg
+  - a build and release triggered by Woodpecker CI
   - since we did not select `lib`, we got an app build profile, for which
     there is no publish to npm
 
@@ -158,14 +193,14 @@ The screen cast below shows the process for Level 1. Note:
     alt="update-markdown-toc demo">
 </p>
 
-After we ran the screen cast steps we were able to screenshot how our push triggered a build o
-onthe  Github CI servers.
+After we ran the screen cast steps we were able to screenshot how our push triggered a build on
+Woodpecker CI.
 
 <p align="center">
   <img
     src="docs/github-actions.png"
     width="720"
-    alt="github-actions-view">
+    alt="woodpecker-ci-view">
 </p>
 
 
@@ -208,7 +243,7 @@ is _why_.)
 | **Stubs** — `src/top-level/*` seeded into the project root | Zero-config entry points that only `extends` the presets | Minimal setup |
 | **Pipeline** — `src/pipeline/*` copied on install | A working release + changeset workflow with no hand-wiring; drift is diff-warned | Both |
 | **Convention checks** — postinstall warns on missing `ci` / `update-all-format` | An install-time nudge toward the shared command surface | Consistency |
-| **`ci` gate** — `release.yml` runs `npm run ci` | Fail-closed enforcement: a repo that ignores the convention cannot release | Consistency (hard teeth) |
+| **`ci` gate** — `.woodpecker.yml` runs `npm run ci` | Fail-closed enforcement: a repo that ignores the convention cannot release | Consistency (hard teeth) |
 | **Policy doc** — `docs/RELEASE-PROCESS.md`, linked never copied | One canonical release policy, impossible to drift | Consistency |
 | **Assets** — `assets/image/*` seeded into `docs/assets/` | Shared brand logos with no per-repo copies to maintain | Minimal setup |
 | **Shell aliases** — `assets/shell/aliases.sh`, cloned + sourced (never shipped to npm) | One standard way for the team to create and scaffold repos (`mkrepo`, `dk-*`) | Consistency |
@@ -335,10 +370,10 @@ versions of these tools may produce peer dependency conflicts.
 - TypeScript config (`tsconfig.json`, `tsconfig.test.json`, `tsconfig.eslint.json`)
 - Postinstall script that copies starter top-level config files into your
   project root, extending the configs installed under `node_modules`
-- GitHub Actions release workflow (`.github/workflows/release.yml`)
+- Woodpecker CI release workflow (`.woodpecker.yml`)
 - Changeset config (`.changeset/config.json`)
 - Auto-changeset script (`scripts/auto-changeset.sh`)
-- NPM token diagnostic workflow (`.github/workflows/verify-npm-token.yml`) — see
+- NPM token diagnostic instructions — see
   [Troubleshooting Publish Auth](docs/RELEASE-PROCESS.md#troubleshooting-publish-auth)
 - Playwright config helper (`@doikayt/typescript-build-config/playwright`) — `nixChromiumLaunchOptions()`
   discovers the system Chromium on quirky NixOS; `definePlaywrightConfig()` wraps `defineConfig` and
@@ -410,7 +445,7 @@ components.
         │       │         prettier.config.js  …           │
         │       └────extends────► presets living in       │
         │                         node_modules  (chan. 1) │
-        │  owned pipeline:  .github/workflows/release.yml │
+        │  owned pipeline:  .woodpecker.yml                │
         │                   scripts/auto-changeset.sh     │
         │  owned assets:    docs/assets/doikayt-logo.*    │
         │  CONTRIBUTING.md ─cites URL─► RELEASE-PROCESS.md│
@@ -502,9 +537,7 @@ On `npm update`, the behavior per file is:
 This means local customisations are never silently overwritten, but you are
 notified when your copy has drifted from the upstream version.
 
-The release pipeline requires an `NPM` secret stored at the GitHub organisation
-level. All repos under the org inherit it automatically — no per-repo secret
-configuration is needed.
+The release pipeline requires `NPM` and `CODEBERG_TOKEN` secrets in Woodpecker.
 
 ## Conventions Every Project Must Adhere To
 
@@ -601,7 +634,7 @@ directly.
 
 ## Publishing
 
-Releases are automated via Changesets and GitHub Actions. The full policy —
+Releases are automated via Changesets and Woodpecker CI. The full policy —
 commit-prefix → bump mapping, forcing or suppressing a release, resolving
 `changeset status` errors, verifying a release, troubleshooting publish auth —
 is documented in [docs/RELEASE-PROCESS.md](docs/RELEASE-PROCESS.md). That
@@ -620,28 +653,32 @@ present. For majors this is mandatory: a breaking-change commit (`feat!:` or
 `BREAKING CHANGE` in the body) with no handwritten changeset fails the
 release job until one is committed.
 
-**Manual publish (emergency):** trigger the workflow manually via
-**GitHub Actions → CI / Release → Run workflow** on the `main` branch.
+**Manual publish (emergency):** trigger a Woodpecker pipeline on the `main` branch.
 
 ## Team shell aliases
 
 Installed by [Quick start](#quick-start) step 1 (or manually: add
-`source <clone-path>/assets/shell/aliases.sh` to your shell rc). They require `gh`
-(authenticated) and `node`/`npm`.
+`source <clone-path>/assets/shell/aliases.sh` to your shell rc). They require
+`curl`, `CODEBERG_TOKEN`, and `node`/`npm`.
 
 | Alias | What it does |
 | --- | --- |
 | `mkrepo <name>` | Create a public repo in the `doikayt` org (guards against duplicates). |
+| `addpush [name]` | Wire up the current directory to an existing Codeberg repo (create it first with `mkrepo`) and push. Defaults `name` to the current directory. |
 | `dk-new` | `npm init -y` + `@doikayt` scope. |
 | `dk-init` | Scaffold the build config into the current project. |
-| `dk-scaffold <name>\|. [lib\|app]` | Create the repo, scaffold, and push — one command (defaults to app). Pass `.` to scaffold in the current directory, using its leaf name as `@doikayt/<package-name>`. |
+| `dk-scaffold <name>\|. [lib\|app] [--local] [-q]` | Create the repo, scaffold, and push — one command (defaults to app). Pass `.` to scaffold in the current directory, using its leaf name as `@doikayt/<package-name>`. `--local` skips the repo and push; `-q` hides the auto-answered-prompts note. |
+| `gp` | Pull with rebase, then push the current branch. The everyday git sync command — requires the branch to already track a remote. |
+| `gpu` | First push of a new local branch: sets it up to track `origin` and pushes (or just wires up tracking if `origin` already has a same-named branch). |
+| `trackify` | Set the upstream tracking branch for the current branch to the same-named branch on `origin`, without pushing. Fails if that remote branch doesn't exist yet. |
+| `tools-help` | Print every alias/function in `aliases.sh`, grouped, with a one-line summary parsed from each one's own doc comment — the full, always-current list (diff helpers, cleanup helpers, etc.) lives there instead of being duplicated in this table. |
 
 ## For Maintainers
 
 ### Clone and install
 
 ```bash
-git clone git@github.com:doikayt/typescript-build-config.git
+git clone git@codeberg.org:doikayt/typescript-build-config.git
 cd typescript-build-config
 npm install
 ```
@@ -679,3 +716,6 @@ by hand, with what to look for at each step — follow
 MIT
 
 
+
+[![Remember the USS Liberty!](https://badge.techforpalestine.org/ceasefire-now)](https://techforpalestine.org/learn-more)
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doikayt/typescript-build-config",
-  "version": "0.1.32",
+  "version": "0.1.37",
   "description": "Shared build configuration for TypeScript projects — ESLint, Prettier, tsconfig, and Playwright presets",
   "_comments": {
     "exports": "This block lists the config files that will be extended by files in in src/toplevel - which are copied to consuming project root folder. An example: eslint.config.js imports from '@doikayt/typescript-build-config/eslint'.",
@@ -43,8 +43,8 @@
     "@playwright/test": "^1.40.0"
   },
   "dependencies": {
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "eslint": "^9.0.0",
     "prettier": "^3.0.0"
   },
@@ -59,12 +59,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+ssh://git@github.com/doikayt/typescript-build-config.git"
+    "url": "git+ssh://git@codeberg.org/doikayt/typescript-build-config.git"
   },
   "peerDependencies": {
+    "@playwright/test": ">=1.40.0",
     "@typescript-eslint/eslint-plugin": "^8.57.1",
-    "@typescript-eslint/parser": "^8.57.1",
-    "@playwright/test": ">=1.40.0"
+    "@typescript-eslint/parser": "^8.57.1"
   },
   "peerDependenciesMeta": {
     "@playwright/test": {

package/src/canonical-scripts.js

@@ -31,7 +31,7 @@ export function canonicalScripts({ ui = false, library = false } = {}) {
 }
 
 export function devDependencyNames({ ui = false } = {}) {
-  // @changesets/cli is required by the release pipeline (release.yml runs
+  // @changesets/cli is required by the release pipeline (.woodpecker.yml runs
   // `npx changeset version` / `publish`), so every consumer needs it installed —
   // otherwise `npx changeset` can't resolve the `changeset` bin and the release
   // job fails with "could not determine executable to run".

package/src/init.js

@@ -28,6 +28,17 @@ function seedFile(src, destPath) {
   return "seeded";
 }
 
+// Write an MIT LICENSE from the template when the project has none. The holder
+// is the owning org (REPO_OWNER); without one, a neutral "project contributors".
+function seedLicense(destPath, { holder, year }) {
+  if (existsSync(destPath)) return "skipped";
+  const text = readFileSync(resolve(templatesDir, "LICENSE"), "utf8")
+    .replace("{{YEAR}}", String(year))
+    .replace("{{HOLDER}}", holder);
+  writeFileSync(destPath, text);
+  return "seeded";
+}
+
 // Recursively copy a template directory tree into the project.
 function copyDir(srcDir, destDir) {
   mkdirSync(destDir, { recursive: true });
@@ -83,6 +94,8 @@ export async function runInit({
   promptText,
   resolveDevVersions = resolveVersions,
   log = console.log,
+  licenseHolder = process.env.REPO_OWNER,
+  licenseYear = new Date().getFullYear(),
 } = {}) {
   // One readline interface for all prompts (see createAskYesNo); close it even
   // on error so a leftover interface never keeps the process alive.
@@ -98,6 +111,8 @@ export async function runInit({
       askText,
       resolveDevVersions,
       log,
+      licenseHolder,
+      licenseYear,
     });
   } finally {
     ownAsk?.close();
@@ -110,6 +125,8 @@ async function collectAndScaffold({
   askText,
   resolveDevVersions,
   log,
+  licenseHolder,
+  licenseYear,
 }) {
   const pkgPath = resolve(cwd, "package.json");
   const raw = readFileSync(pkgPath, "utf8");
@@ -146,12 +163,13 @@ async function collectAndScaffold({
   const scripts = canonicalScripts({ ui, library });
   const devDependencies = resolveDevVersions(devDependencyNames({ ui }));
 
-  const fields = packageFields({ library });
+  const fields = { ...packageFields({ library }), license: "MIT" };
   // `npm init -y` seeds these placeholders; treat them as unset so the canonical
-  // `test` script and (for a library) `main` replace them instead of shadowing.
+  // `test` script, `license` and (for a library) `main` replace them instead of
+  // shadowing.
   const replaceDefaults = {
     scripts: { test: 'echo "Error: no test specified" && exit 1' },
-    fields: { main: "index.js" },
+    fields: { main: "index.js", license: "ISC" },
   };
   if (library) {
     // The chosen name is a deliberate publish decision, so it replaces whatever
@@ -177,6 +195,17 @@ async function collectAndScaffold({
     (result === "seeded" ? seededConfigs : keptConfigs).push(name);
   }
 
+  // Codeberg's CI access request requires a LICENSE file. Seed one only when
+  // the project's license is MIT (the canonical one), so a consumer who chose a
+  // different license is never handed a contradicting file.
+  if (JSON.parse(text).license === "MIT") {
+    const result = seedLicense(resolve(cwd, "LICENSE"), {
+      holder: licenseHolder || "the project contributors",
+      year: licenseYear,
+    });
+    (result === "seeded" ? seededConfigs : keptConfigs).push("LICENSE");
+  }
+
   const demo = wantDemo
     ? scaffoldDemo({ cwd })
     : {

package/src/new-package.js

@@ -3,9 +3,18 @@ import { resolve } from "path";
 import { spawnSync } from "child_process";
 import { scopeName } from "./scope-name.js";
 
+export function npmExecutableName() {
+  return process.platform === "win32" ? "npm.cmd" : "npm";
+}
+
 // Default `npm init -y` runner. Injectable so runNew is testable without npm.
 function npmInitY(cwd) {
-  const res = spawnSync("npm", ["init", "-y"], { cwd, stdio: "inherit" });
+  const npmCommand = npmExecutableName();
+  const res = spawnSync(npmCommand, ["init", "-y"], {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+  });
   if (res.error) throw res.error;
   if (res.status !== 0)
     throw new Error(`npm init -y exited with ${res.status}`);

package/src/pipeline/woodpecker.yml

@@ -0,0 +1,50 @@
+# Canonical pipeline is maintained in src/pipeline/woodpecker.yml.
+# Keep this root copy in sync for this repository.
+steps:
+  ci:
+    image: node:22
+    commands:
+      - npm ci
+      - npm run ci
+      - if [ "$CI_PIPELINE_EVENT" = "pull_request" ]; then npx changeset status; fi
+    when:
+      - event: [push, pull_request, tag]
+
+  verify-npm-token:
+    image: node:22
+    commands:
+      - 'echo "//registry.npmjs.org/:_authToken=$NPM" > ~/.npmrc'
+      - npm whoami
+    environment:
+      NPM:
+        from_secret: NPM
+    when:
+      - event: manual
+
+  release:
+    image: node:22
+    depends_on:
+      - ci
+    commands:
+      - apt-get update && apt-get install -y --no-install-recommends git bash
+      - npm ci
+      - 'if [ "$(git rev-parse --is-shallow-repository)" = true ]; then git fetch --unshallow --tags --force; else git fetch --tags --force; fi'
+      - git config user.name "doikayt-release-bot"
+      - git config user.email "doikayt-release-bot@codeberg.org"
+      - bash scripts/auto-changeset.sh
+      - npx changeset version
+      - git add .
+      - 'git diff --staged --quiet || git commit -m "chore: release [CI SKIP]"'
+      - git remote set-url origin "https://$CODEBERG_TOKEN@codeberg.org/$CI_REPO.git"
+      - git push origin HEAD:main
+      - 'echo "//registry.npmjs.org/:_authToken=$NPM" > ~/.npmrc'
+      - npx changeset publish
+      - git push origin --tags
+    environment:
+      CODEBERG_TOKEN:
+        from_secret: CODEBERG_TOKEN
+      NPM:
+        from_secret: NPM
+    when:
+      - event: push
+        branch: main

package/src/postinstall.js

@@ -9,12 +9,35 @@ import { resolve, dirname } from "path";
 import { execSync } from "child_process";
 import { tmpdir } from "os";
 import { join } from "path";
+import { fileURLToPath } from "url";
 
 const PREFIX = "[@doikayt/typescript-build-config]";
 
+export function normalizeProjectRoot(rawPath) {
+  if (!rawPath) return rawPath;
+
+  let normalized = rawPath.replace(/^[A-Za-z]:\\C:\\/, "C:\\");
+  normalized = normalized.replace(
+    /^\/([A-Za-z])\//,
+    (_, drive) => `${drive.toUpperCase()}:\\`,
+  );
+  normalized = normalized.replace(/^\//, "");
+  normalized = normalized.replace(/\\+/g, "\\");
+
+  if (/^([A-Za-z]):\\/.test(normalized)) {
+    return normalized.replace(/\\+/g, "\\");
+  }
+
+  if (/^([A-Za-z]):\//.test(normalized)) {
+    return normalized.replace(/\//g, "\\");
+  }
+
+  return normalized;
+}
+
 console.log(`${PREFIX} Running postinstall...`);
 
-const projectRoot = process.env.INIT_CWD ?? process.cwd();
+const projectRoot = normalizeProjectRoot(process.env.INIT_CWD ?? process.cwd());
 const projectPkgPath = resolve(projectRoot, "package.json");
 
 // Installed via `npx @doikayt/... new` into a bare dir (or otherwise before a
@@ -34,8 +57,8 @@ if (projectPkg.name === "@doikayt/typescript-build-config") {
   process.exit(0);
 }
 
-const srcDir = new URL("top-level", import.meta.url).pathname;
-const pipelineDir = new URL("pipeline", import.meta.url).pathname;
+const srcDir = fileURLToPath(new URL("top-level", import.meta.url));
+const pipelineDir = fileURLToPath(new URL("pipeline", import.meta.url));
 
 // --- Top-level config files: all-or-nothing ---
 
@@ -72,13 +95,9 @@ if (alreadyExist.length > 0) {
 // --- Pipeline files: per-file copy/warn/diff ---
 
 const pipelineFiles = [
-  { src: "release.yml", dest: ".github/workflows/release.yml" },
+  { src: "woodpecker.yml", dest: ".woodpecker.yml" },
   { src: "changeset-config.json", dest: ".changeset/config.json" },
   { src: "auto-changeset.sh", dest: "scripts/auto-changeset.sh" },
-  {
-    src: "verify-npm-token.yml",
-    dest: ".github/workflows/verify-npm-token.yml",
-  },
 ];
 
 for (const { src, dest } of pipelineFiles) {
@@ -111,7 +130,7 @@ for (const { src, dest } of pipelineFiles) {
 
 // --- Asset files: seeded into docs/assets/, same per-file copy/warn as pipeline ---
 
-const assetDir = new URL("../assets/image", import.meta.url).pathname;
+const assetDir = fileURLToPath(new URL("../assets/image", import.meta.url));
 
 const assetFiles = [
   { src: "doikayt-logo.png", dest: "docs/assets/doikayt-logo.png" },

package/src/templates/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{YEAR}} {{HOLDER}}
+
+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/src/templates/demo/README.md

@@ -9,7 +9,7 @@
 > before you write any code. Replace them with your own whenever you like —
 > `init` printed the exact paths to delete.
 
-Run `npm run update-all-format` to fill the blocks below; GitHub renders the
+Run `npm run update-all-format` to fill the blocks below; Codeberg renders the
 Mermaid diagrams inline from the fenced blocks.
 
 ## Build Pipeline
@@ -40,3 +40,5 @@ npm test                    # the seeded vitest test passes
 npm run update-all-format   # fills the doc blocks above
 git commit -am "feat: initial version" && git push   # feat:/fix: cut a release (npm publish if a library)
 ```
+
+[![Free Palestine!](https://badge.techforpalestine.org/ceasefire-now)](https://techforpalestine.org/learn-more)

package/src/templates/demo/src/math-engine/_COMPONENT_INFO.md

@@ -1,2 +1,3 @@
 The math-engine component: a small, dependency-free arithmetic core. It validates
 operands and returns a structured result describing the operation performed.
+

package/src/pipeline/release.yml

@@ -1,72 +0,0 @@
-name: CI / Release
-
-permissions:
-  contents: write
-
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  ci:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-      - uses: actions/setup-node@v5
-        with:
-          node-version: 22
-          cache: npm
-      - run: npm ci
-      - run: npm run ci
-      - name: Check Changesets (PR only)
-        if: github.event_name == 'pull_request'
-        run: npx changeset status
-
-  release:
-    needs: ci
-    if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
-    permissions:
-      contents: write
-      id-token: write
-    concurrency:
-      group: release
-      cancel-in-progress: false
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-node@v5
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org
-          cache: npm
-      - run: npm ci
-      - name: Configure git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-      - name: Auto-generate changeset from commits
-        run: bash scripts/auto-changeset.sh
-      - name: Apply version bumps
-        run: npx changeset version
-      - name: Commit and push version bumps
-        run: |
-          git add .
-          git diff --staged --quiet && echo "No changesets to release" || \
-            (git commit -m "chore: release [skip ci]" && git push)
-      - name: Publish
-        id: publish
-        run: npx changeset publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM }}
-      - name: Push release tags
-        run: git push --tags
-      - name: Post-publish hook (optional)
-        if: steps.publish.outcome == 'success'
-        run: |
-          node -e "process.exit(require('./package.json').scripts?.['post-publish'] ? 0 : 1)" \
-            && npm run post-publish \
-            || echo "No post-publish script — skipping"

package/src/pipeline/verify-npm-token.yml

@@ -1,17 +0,0 @@
-name: Verify NPM Token
-
-on:
-  workflow_dispatch:
-
-jobs:
-  verify-token:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/setup-node@v5
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org
-      - name: Check npm auth
-        run: npm whoami
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM }}