@rtorcato/repo-tooling 2.59.0

package/tooling/github-actions/workflows/cloudflare-pages.yml

@@ -0,0 +1,42 @@
+# Deploy a static build to Cloudflare Pages on push to main.
+# Secrets: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
+# Set your Pages project name below (replace YOUR_PROJECT) and the build
+# output dir if it isn't `dist`.
+name: ☁️ Cloudflare Pages Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  deployments: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build
+        run: pnpm build
+
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy dist --project-name=YOUR_PROJECT

package/tooling/github-actions/workflows/docker-publish.yml

@@ -0,0 +1,44 @@
+# Build and publish a Docker image to GHCR on tag push.
+# Requires a Dockerfile at the repo root. No extra secrets needed —
+# GITHUB_TOKEN authenticates to ghcr.io for the current repository.
+name: 🐳 Docker Publish
+
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  docker:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract image metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

package/tooling/github-actions/workflows/preview-deployments.yml

@@ -0,0 +1,54 @@
+# Per-PR preview deploy to Vercel. Posts a preview URL for every pull request
+# so reviewers can click through the change before merge.
+# Secrets: VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID
+name: 🔍 Preview Deployment
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+env:
+  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Pull Vercel environment
+        run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Build project artifacts
+        run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Deploy preview
+        id: deploy
+        run: |
+          url=$(vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }})
+          echo "url=$url" >> "$GITHUB_OUTPUT"
+
+      - name: Comment preview URL on the PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: `🔍 Preview deployed: ${{ steps.deploy.outputs.url }}`,
+            })

package/tooling/github-actions/workflows/vercel-deploy.yml

@@ -0,0 +1,40 @@
+# Production deploy to Vercel on push to main.
+# Secrets: VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID
+# (Project Settings → Tokens, and `vercel link` writes the org/project IDs.)
+name: ▲ Vercel Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: Install Vercel CLI
+        run: npm install --global vercel@latest
+
+      - name: Pull Vercel environment
+        run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Build project artifacts
+        run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Deploy to production
+        run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}

package/tooling/jest-presets/browser/jest-preset.d.mts

@@ -0,0 +1,4 @@
+import type { Config } from 'jest'
+
+declare const config: Config
+export default config

package/tooling/jest-presets/browser/jest-preset.mjs

@@ -0,0 +1,14 @@
+module.exports = {
+	roots: ['<rootDir>'],
+	testEnvironment: 'jsdom',
+	transform: {
+		'^.+\\.tsx?$': 'ts-jest',
+	},
+	moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+	modulePathIgnorePatterns: [
+		'<rootDir>/test/__fixtures__',
+		'<rootDir>/node_modules',
+		'<rootDir>/dist',
+	],
+	preset: 'ts-jest',
+}

package/tooling/jest-presets/node/jest-preset.d.mts

@@ -0,0 +1,4 @@
+import type { Config } from 'jest'
+
+declare const config: Config
+export default config

package/tooling/jest-presets/node/jest-preset.mjs

@@ -0,0 +1,13 @@
+module.exports = {
+	roots: ['<rootDir>'],
+	transform: {
+		'^.+\\.tsx?$': 'ts-jest',
+	},
+	moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+	modulePathIgnorePatterns: [
+		'<rootDir>/test/__fixtures__',
+		'<rootDir>/node_modules',
+		'<rootDir>/dist',
+	],
+	preset: 'ts-jest',
+}

package/tooling/mcp/mcp.json.example

@@ -0,0 +1,27 @@
+{
+  // Model Context Protocol servers for this project.
+  //
+  // This is a TEMPLATE (.mcp.json.example) — it is never loaded, so comments are
+  // safe here. To activate: copy it to `.mcp.json`, remove the comments (real
+  // .mcp.json is strict JSON), and fill in the servers you actually want.
+  //
+  //   cp .mcp.json.example .mcp.json
+  //
+  // Only add servers you need — most GitHub work is already covered by the `gh`
+  // CLI, so a GitHub MCP server is usually redundant.
+  //
+  // Example entries (uncomment and adapt in the real .mcp.json):
+  //
+  // "mcpServers": {
+  //   "filesystem": {
+  //     "command": "npx",
+  //     "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+  //   },
+  //   "postgres": {
+  //     "command": "npx",
+  //     "args": ["-y", "@modelcontextprotocol/server-postgres"],
+  //     "env": { "DATABASE_URL": "${DATABASE_URL}" }
+  //   }
+  // }
+  "mcpServers": {}
+}

package/tooling/nx/nx.json

@@ -0,0 +1,24 @@
+{
+	"$schema": "https://raw.githubusercontent.com/nrwl/nx/master/packages/nx/schemas/nx-schema.json",
+	"namedInputs": {
+		"default": ["{projectRoot}/**/*", "sharedGlobals"],
+		"production": ["default"],
+		"sharedGlobals": []
+	},
+	"targetDefaults": {
+		"build": {
+			"dependsOn": ["^build"],
+			"outputs": ["{projectRoot}/dist"],
+			"cache": true
+		},
+		"lint": { "cache": true },
+		"typecheck": {
+			"dependsOn": ["^build"],
+			"cache": true
+		},
+		"test": {
+			"dependsOn": ["^build"],
+			"cache": true
+		}
+	}
+}

package/tooling/oxlint/README.md

@@ -0,0 +1,25 @@
+# Oxlint preset
+
+Shared [Oxlint](https://oxc.rs/docs/guide/usage/linter.html) configuration for projects using `@rtorcato/repo-tooling`.
+
+Oxlint is a Rust-based linter that's 50–100× faster than ESLint. It is intentionally **additive** to Biome — Biome handles formatting and the broad lint baseline, Oxlint adds a faster pass for the type-aware and import rules Biome doesn't cover yet.
+
+## Usage
+
+```bash
+npx @rtorcato/repo-tooling copy oxlint
+```
+
+This drops `.oxlintrc.json` at the project root, extending the conventions in this preset. Run it with:
+
+```bash
+pnpm oxlint
+# or
+npx oxlint
+```
+
+## Notes
+
+- Oxlint shares its rule catalog with ESLint's plugins (`typescript`, `unicorn`, `oxc`, `import`), so most ESLint rules you know already work here.
+- The preset disables Biome-overlapping rules to keep CI noise down — Biome stays the source of truth for formatting and the baseline lint set.
+- For projects without Biome, you can run Oxlint standalone and re-enable the `style` and `pedantic` categories.

package/tooling/oxlint/oxlintrc.json

@@ -0,0 +1,28 @@
+{
+	"$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
+	"categories": {
+		"correctness": "error",
+		"perf": "warn",
+		"suspicious": "warn",
+		"pedantic": "off",
+		"style": "off",
+		"restriction": "off",
+		"nursery": "off"
+	},
+	"plugins": ["typescript", "unicorn", "oxc", "import"],
+	"rules": {
+		"no-console": "warn",
+		"no-debugger": "error",
+		"no-empty": "warn",
+		"no-unused-vars": "off",
+		"@typescript-eslint/no-unused-vars": [
+			"warn",
+			{ "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }
+		],
+		"unicorn/filename-case": "off",
+		"unicorn/no-null": "off",
+		"unicorn/prevent-abbreviations": "off",
+		"import/no-default-export": "off"
+	},
+	"ignorePatterns": ["node_modules", "dist", "build", "coverage", ".next", "*.d.ts"]
+}

package/tooling/playwright/playwright.config.d.mts

@@ -0,0 +1,4 @@
+import type { PlaywrightTestConfig } from '@playwright/test'
+
+declare const config: PlaywrightTestConfig
+export default config

package/tooling/playwright/playwright.config.mjs

@@ -0,0 +1,19 @@
+import { defineConfig, devices } from '@playwright/test'
+
+export default defineConfig({
+	testDir: './tests/e2e',
+	fullyParallel: true,
+	forbidOnly: !!process.env.CI,
+	retries: process.env.CI ? 2 : 0,
+	workers: process.env.CI ? 1 : undefined,
+	reporter: 'html',
+	use: {
+		baseURL: process.env.PLAYWRIGHT_BASE_URL ?? 'http://localhost:3000',
+		trace: 'on-first-retry',
+	},
+	projects: [
+		{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+		{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+		{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
+	],
+})

package/tooling/prettier/index.d.mts

@@ -0,0 +1,4 @@
+import type { Config } from 'prettier'
+
+declare const config: Config
+export default config

package/tooling/prettier/index.mjs

@@ -0,0 +1,36 @@
+// import { fileURLToPath } from "url";
+
+/** @typedef {import("prettier").Config} PrettierConfig */
+/** @typedef {import("prettier-plugin-tailwindcss").PluginOptions} TailwindConfig */
+/** @typedef {import("@ianvs/prettier-plugin-sort-imports").PluginConfig} SortImportsConfig */
+
+/** @type { PrettierConfig | SortImportsConfig  } */
+const config = {
+	singleQuote: true,
+	semi: false,
+	// we only need prettier plugin for tailwind if we are not in vscode and don't use tailwind plugin
+	// plugins: ['@ianvs/prettier-plugin-sort-imports', 'prettier-plugin-tailwindcss'],
+	plugins: ['@ianvs/prettier-plugin-sort-imports'],
+	// tailwindConfig: fileURLToPath(new URL('../../packages/ui/tailwind/web.ts', import.meta.url)),
+	// tailwindFunctions: ['cn', 'cva'],
+	importOrder: [
+		//
+		'<TYPES>',
+		'^(react/(.*)$)|^(react$)|^(react-native(.*)$)',
+		'^(next/(.*)$)|^(next$)',
+		'^(expo(.*)$)|^(expo$)',
+		'<THIRD_PARTY_MODULES>',
+		'',
+		'<TYPES>^@acme',
+		'^@acme/(.*)$',
+		'',
+		'<TYPES>^[.|..|~]',
+		'^~/',
+		'^[../]',
+		'^[./]',
+	],
+	importOrderParserPlugins: ['typescript', 'jsx', 'decorators-legacy'],
+	importOrderTypeScriptVersion: '4.4.0',
+}
+
+export default config

package/tooling/release-please/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+	".": "0.0.0"
+}

package/tooling/release-please/release-please-config.json

@@ -0,0 +1,9 @@
+{
+	"$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+	"packages": {
+		".": {
+			"release-type": "node",
+			"changelog-path": "CHANGELOG.md"
+		}
+	}
+}

package/tooling/rolldown/rolldown.config.d.mts

@@ -0,0 +1,18 @@
+import type { RolldownOptions } from 'rolldown'
+
+export interface GetConfigOptions {
+	/** Library entry point. Default: `src/index.ts`. */
+	input?: string
+	/** Output directory for the bundle. Default: `dist`. */
+	outDir?: string
+	/** Emit sourcemaps. Default: `true`. */
+	sourcemap?: boolean
+	/** Which ids to leave external. Default: every bare (non-relative) import. */
+	external?: RolldownOptions['external']
+}
+
+/** Build the ESM + CJS Rolldown config for a TypeScript library. */
+export declare function getConfig(options?: GetConfigOptions): RolldownOptions
+
+declare const config: RolldownOptions
+export default config

package/tooling/rolldown/rolldown.config.mjs

@@ -0,0 +1,59 @@
+import { defineConfig } from 'rolldown'
+
+/**
+ * Rolldown config factory for TypeScript libraries.
+ *
+ * Rolldown is the Rust-based, Rollup-API-compatible bundler (the one Vite uses
+ * internally). Mirrors the rollup preset's intent — unbundled per-file output
+ * (`preserveModules`), dual ESM + CJS, and every bare import left external so
+ * dependencies aren't inlined — but needs no `@rollup/plugin-typescript`:
+ * Rolldown transpiles TypeScript natively.
+ *
+ * Consumers scaffold a `rolldown.config.mjs` that re-exports the default:
+ *
+ *   export { default } from '@rtorcato/repo-tooling/rolldown'
+ *
+ * …or customize the entry / output:
+ *
+ *   import { getConfig } from '@rtorcato/repo-tooling/rolldown'
+ *   export default getConfig({ input: 'src/main.ts' })
+ *
+ * Type declarations (`.d.ts`) are not emitted here — run `tsc --emitDeclarationOnly`
+ * (or Rolldown's experimental `dts` output) alongside the bundle.
+ *
+ * @param {import('./rolldown.config.d.mts').GetConfigOptions} [options]
+ */
+export function getConfig(options = {}) {
+	const { input = 'src/index.ts', outDir = 'dist', sourcemap = true, external = isBareImport } = options
+
+	return defineConfig({
+		input,
+		external,
+		output: [
+			{
+				dir: outDir,
+				format: 'esm',
+				entryFileNames: '[name].mjs',
+				preserveModules: true,
+				sourcemap,
+			},
+			{
+				dir: outDir,
+				format: 'cjs',
+				entryFileNames: '[name].cjs',
+				preserveModules: true,
+				exports: 'named',
+				sourcemap,
+			},
+		],
+	})
+}
+
+// Treat every non-relative, non-absolute id as an external dependency so the
+// library ships thin and deps resolve from the consumer's node_modules.
+// (`\0`-prefixed ids are virtual modules — never externalize those.)
+function isBareImport(id) {
+	return !id.startsWith('.') && !id.startsWith('/') && !id.startsWith('\0')
+}
+
+export default getConfig()

package/tooling/rollup/rollup.config.d.mts

@@ -0,0 +1,20 @@
+import type { RollupOptions } from 'rollup'
+
+export interface GetConfigOptions {
+	/** Library entry point. Default: `src/index.ts`. */
+	input?: string
+	/** Output directory for JS + declarations. Default: `dist`. */
+	outDir?: string
+	/** Emit sourcemaps. Default: `true`. */
+	sourcemap?: boolean
+	/** Which ids to leave external. Default: every bare (non-relative) import. */
+	external?: RollupOptions['external']
+	/** Path to the tsconfig plugin-typescript should use. Default: `./tsconfig.json`. */
+	tsconfig?: string
+}
+
+/** Build the ESM + CJS Rollup configs for a TypeScript library. */
+export declare function getConfig(options?: GetConfigOptions): RollupOptions[]
+
+declare const config: RollupOptions[]
+export default config

package/tooling/rollup/rollup.config.mjs

@@ -0,0 +1,70 @@
+import typescript from '@rollup/plugin-typescript'
+
+/**
+ * Rollup config factory for TypeScript libraries.
+ *
+ * Mirrors the tsup preset: unbundled per-file output (`preserveModules`),
+ * dual ESM + CJS, `.d.ts` declarations emitted once from the ESM pass, and
+ * every bare import left external so dependencies aren't inlined.
+ *
+ * Consumers scaffold a `rollup.config.mjs` that re-exports the default:
+ *
+ *   export { default } from '@rtorcato/repo-tooling/rollup'
+ *
+ * …or customize the entry / output:
+ *
+ *   import { getConfig } from '@rtorcato/repo-tooling/rollup'
+ *   export default getConfig({ input: 'src/main.ts' })
+ *
+ * @param {import('./rollup.config.d.mts').GetConfigOptions} [options]
+ */
+export function getConfig(options = {}) {
+	const {
+		input = 'src/index.ts',
+		outDir = 'dist',
+		sourcemap = true,
+		external = isBareImport,
+		tsconfig = './tsconfig.json',
+	} = options
+
+	// Declarations are emitted once, from the ESM pass — plugin-typescript
+	// requires declarationDir to sit inside the output dir, and running it in
+	// both passes would double-write the same .d.ts files.
+	const esm = {
+		input,
+		external,
+		output: {
+			dir: outDir,
+			format: 'es',
+			entryFileNames: '[name].mjs',
+			preserveModules: true,
+			sourcemap,
+		},
+		plugins: [typescript({ tsconfig, declaration: true, declarationDir: outDir, rootDir: 'src' })],
+	}
+
+	const cjs = {
+		input,
+		external,
+		output: {
+			dir: outDir,
+			format: 'cjs',
+			entryFileNames: '[name].cjs',
+			preserveModules: true,
+			exports: 'named',
+			sourcemap,
+		},
+		plugins: [typescript({ tsconfig, declaration: false })],
+	}
+
+	return [esm, cjs]
+}
+
+// Treat every non-relative, non-absolute id as an external dependency so the
+// library ships thin and deps resolve from the consumer's node_modules.
+// (`\0`-prefixed ids are Rollup's virtual modules — never externalize those.)
+function isBareImport(id) {
+	return !id.startsWith('.') && !id.startsWith('/') && !id.startsWith('\0')
+}
+
+export default getConfig()

package/tooling/semantic-release/docker.d.mts

@@ -0,0 +1,4 @@
+import type { Options } from 'semantic-release'
+
+declare const config: Options
+export default config

package/tooling/semantic-release/docker.mjs

@@ -0,0 +1,59 @@
+export default {
+	branches: [
+		'+([0-9])?(.{+([0-9]),x}).x',
+		'main',
+		'ci-testing',
+		'next',
+		'release',
+		'next-major',
+		{ name: 'beta', prerelease: true },
+		{ name: 'alpha', prerelease: true },
+	],
+	repositoryUrl: `https://gitlab-ci-token:${process.env.GITLAB_TOKEN}@gitlab.com/${process.env.CI_PROJECT_NAMESPACE}/${process.env.CI_PROJECT_NAME}.git`,
+	plugins: [
+		[
+			'@semantic-release/commit-analyzer',
+			{
+				preset: 'conventionalcommits',
+				releaseRules: [
+					{ breaking: true, release: 'major' }, // Major release for breaking changes
+					{ type: 'feat', release: 'minor' }, // Minor release for features
+					{ type: 'fix', release: 'patch' }, // Patch release for bug fixes
+					{
+						type: 'docs', // Documentation changes
+						scope: 'README', // Specific scope for README changes
+						release: false, // no Patch release for README changes
+					},
+					{ type: 'refactor', release: 'patch' },
+					{ type: 'revert', release: 'patch' },
+					{ type: 'style', release: false },
+					{ type: 'test', release: false },
+					// { type: 'chore', release: 'patch' }, // Chore changes
+				],
+				parserOpts: {
+					noteKeywords: ['BREAKING CHANGE', 'BREAKING CHANGES', 'BREAKING'],
+				},
+			},
+		],
+		'@semantic-release/release-notes-generator',
+		// Release notes generator plugin to generate release notes
+		[
+			'@semantic-release/gitlab',
+			{
+				assets: ['dist/*.js', 'dist/*.js.map', 'CHANGELOG.md', 'package.json', 'README.md'],
+				message: 'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+				gitlabUrl: 'https://gitlab.com',
+			},
+		],
+		[
+			'@semantic-release/exec',
+			{
+				prepareCmd: `
+					docker push registry.gitlab.com/${CI_PROJECT_PATH}:${nextRelease.version} &&
+					docker tag registry.gitlab.com/${CI_PROJECT_PATH}:${nextRelease.version} registry.gitlab.com/${CI_PROJECT_PATH}:latest &&
+					docker push registry.gitlab.com/${CI_PROJECT_PATH}:latest
+				`,
+			},
+		],
+	],
+}

package/tooling/semantic-release/github.d.mts

@@ -0,0 +1,4 @@
+import type { Options } from 'semantic-release'
+
+declare const config: Options
+export default config