@integr8-media/config 1.0.0 → 1.2.0

package/dist/registrySite.mjs

@@ -0,0 +1,3 @@
+import { t as ConfigError } from "./configError-Cap5gwBB.mjs";
+import { A as cssToText, B as renderMarkdown, C as readSiteSwitch, D as uiDocsUrlOf, E as resolveSiteConfig, F as normalizeSitePath, H as typeLabel, I as playgroundBase, L as escapeHtml, M as itemDocs, N as renderItemPage, O as RegistrySiteError, P as extractDocs, R as groupItems, S as readPackageAndSwitch, T as resolveRegistryUrl, V as renderShell, _ as renderSiteFiles, a as serveSite, b as readLadleStories, c as formatReport, d as packageOf, f as publicExports, g as loadSiteConfig, h as checkPlaygroundBase, i as resolveSiteFile, j as importLines, k as renderRegistryPage, l as formatSummary, m as buildRegistrySite, n as runCli, o as OWN_CODE, p as shortPath, r as createSiteServer, s as formatKb, t as USAGE, u as groupByPackage, v as defaultStoryOf, w as defineRegistrySite, x as storiesOf, y as previewStoryOf, z as inlineMarkdown } from "./cli-DIsoGTED.mjs";
+export { ConfigError, OWN_CODE, RegistrySiteError, USAGE, buildRegistrySite, checkPlaygroundBase, createSiteServer, cssToText, defaultStoryOf, defineRegistrySite, escapeHtml, extractDocs, formatKb, formatReport, formatSummary, groupByPackage, groupItems, importLines, inlineMarkdown, itemDocs, loadSiteConfig, normalizeSitePath, packageOf, playgroundBase, previewStoryOf, publicExports, readLadleStories, readPackageAndSwitch, readSiteSwitch, renderItemPage, renderMarkdown, renderRegistryPage, renderShell, renderSiteFiles, resolveRegistryUrl, resolveSiteConfig, resolveSiteFile, runCli, serveSite, shortPath, storiesOf, typeLabel, uiDocsUrlOf };

package/dist/registrySiteBin.d.mts

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

package/dist/registrySiteBin.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { n as runCli } from "./cli-DIsoGTED.mjs";
+// src/registrySite/bin.ts
+process.exitCode = await runCli(process.argv.slice(2));
+export {};

package/dist/tsdown.d.mts

@@ -10,19 +10,32 @@ interface Integr8TsdownOptions {
   entry: Integr8TsdownEntry;
   /** Target platform. `node` builds for `node24`; the others build for `es2024`. */
   platform: Integr8TsdownPlatform;
+  /**
+   * Build every source file as its own output file instead of one bundle. Defaults to `false`.
+   *
+   * Use it for React libraries whose files start with `'use client'`: each file is built on its
+   * own, so the directive stays on it and a Next.js server component can import the
+   * non-client exports from the same package. The preset then hides rolldown's
+   * `MODULE_LEVEL_DIRECTIVE` warning, which is only noise in that mode. With `false` the
+   * warning stays on, because there it points at a directive that the bundle drops.
+   */
+  unbundle?: boolean;
 }
 /**
  * Builds the shared tsdown config: ESM only, `.d.ts` generation (fast path through
  * isolatedDeclarations), no source maps, a clean output folder and tree-shaking.
  *
+ * With `unbundle: true` each source file becomes its own output file (see
+ * {@link Integr8TsdownOptions.unbundle}).
+ *
  * Output files always use `.mjs` and `.d.mts`, whatever the platform, so a package's
  * `exports` map is the same everywhere. Dependencies and peer dependencies stay external
  * (tsdown's default).
  *
- * @param options - Entry points and target platform.
+ * @param options - Entry points, target platform and the optional `unbundle` switch.
  * @returns A tsdown config to default-export from `tsdown.config.ts`.
- * @throws {@link ConfigError} with code `INVALID_OPTION` for an empty entry or an unknown
- * platform.
+ * @throws {@link ConfigError} with code `INVALID_OPTION` for an empty entry, an unknown
+ * platform or an `unbundle` that is not a boolean.
  *
  * @example
  * ```ts

package/dist/tsdown.mjs

@@ -9,14 +9,17 @@ const PLATFORMS = [
 * Builds the shared tsdown config: ESM only, `.d.ts` generation (fast path through
 * isolatedDeclarations), no source maps, a clean output folder and tree-shaking.
 *
+* With `unbundle: true` each source file becomes its own output file (see
+* {@link Integr8TsdownOptions.unbundle}).
+*
 * Output files always use `.mjs` and `.d.mts`, whatever the platform, so a package's
 * `exports` map is the same everywhere. Dependencies and peer dependencies stay external
 * (tsdown's default).
 *
-* @param options - Entry points and target platform.
+* @param options - Entry points, target platform and the optional `unbundle` switch.
 * @returns A tsdown config to default-export from `tsdown.config.ts`.
-* @throws {@link ConfigError} with code `INVALID_OPTION` for an empty entry or an unknown
-* platform.
+* @throws {@link ConfigError} with code `INVALID_OPTION` for an empty entry, an unknown
+* platform or an `unbundle` that is not a boolean.
 *
 * @example
 * ```ts
@@ -29,6 +32,8 @@ function integr8Tsdown(options) {
 	if (typeof options !== "object" || options === null) throw new ConfigError("INVALID_OPTION", "integr8Tsdown: options are required.");
 	const { platform } = options;
 	if (!PLATFORMS.includes(platform)) throw new ConfigError("INVALID_OPTION", `integr8Tsdown: "platform" must be one of ${PLATFORMS.join(", ")}; got ${String(platform)}.`);
+	const { unbundle = false } = options;
+	if (typeof unbundle !== "boolean") throw new ConfigError("INVALID_OPTION", `integr8Tsdown: "unbundle" must be a boolean; got ${String(unbundle)}.`);
 	return {
 		entry: copyEntry(options.entry),
 		platform,
@@ -38,9 +43,17 @@ function integr8Tsdown(options) {
 		dts: true,
 		sourcemap: false,
 		clean: true,
-		treeshake: true
+		treeshake: true,
+		...unbundle ? {
+			unbundle: true,
+			inputOptions: { onLog: dropDirectiveWarning }
+		} : {}
 	};
 }
+function dropDirectiveWarning(...[level, log, defaultHandler]) {
+	if (log.code === "MODULE_LEVEL_DIRECTIVE") return;
+	defaultHandler(level, log);
+}
 function copyEntry(entry) {
 	if (typeof entry === "string") {
 		if (entry.trim() === "") throw invalidEntry();

package/dist/vitest.d.mts

@@ -8,15 +8,22 @@ interface Integr8VitestOptions {
   environment?: Integr8VitestEnvironment;
   /** Minimum line coverage in percent (0–100). Defaults to `80`. */
   coverageThreshold?: number;
+  /**
+   * Setup file(s) run before each test file, passed to `test.setupFiles` (for example
+   * `'./test/setup.ts'` for Testing Library). Non-empty strings only.
+   */
+  setupFiles?: string | string[];
 }
 /**
  * Builds the shared Vitest config: v8 coverage on `src/**` (tests, `src/index.ts` and
- * `playground/` excluded) that fails when line coverage is below the threshold.
+ * `playground/` excluded) that fails when line coverage is below the threshold. Test collection
+ * skips `playground/**` too, so Playwright specs there are not run by Vitest.
  *
- * @param options - Environment and coverage threshold.
+ * @param options - Environment, coverage threshold and setup files.
  * @returns A Vitest config to default-export from `vitest.config.ts`.
  * @throws {@link ConfigError} with code `INVALID_OPTION` for an unknown environment or a
- * threshold outside 0–100.
+ * threshold outside 0–100, or for `setupFiles` that is not a non-empty string or a non-empty
+ * list of non-empty strings.
  *
  * @example
  * ```ts

package/dist/vitest.mjs

@@ -1,15 +1,18 @@
 import { t as ConfigError } from "./configError-Cap5gwBB.mjs";
+import { configDefaults } from "vitest/config";
 // src/vitest/integr8Vitest.ts
 const ENVIRONMENTS = ["node", "jsdom"];
 const DEFAULT_COVERAGE_THRESHOLD = 80;
 /**
 * Builds the shared Vitest config: v8 coverage on `src/**` (tests, `src/index.ts` and
-* `playground/` excluded) that fails when line coverage is below the threshold.
+* `playground/` excluded) that fails when line coverage is below the threshold. Test collection
+* skips `playground/**` too, so Playwright specs there are not run by Vitest.
 *
-* @param options - Environment and coverage threshold.
+* @param options - Environment, coverage threshold and setup files.
 * @returns A Vitest config to default-export from `vitest.config.ts`.
 * @throws {@link ConfigError} with code `INVALID_OPTION` for an unknown environment or a
-* threshold outside 0–100.
+* threshold outside 0–100, or for `setupFiles` that is not a non-empty string or a non-empty
+* list of non-empty strings.
 *
 * @example
 * ```ts
@@ -23,8 +26,11 @@ function integr8Vitest(options = {}) {
 	const coverageThreshold = options.coverageThreshold ?? DEFAULT_COVERAGE_THRESHOLD;
 	if (!ENVIRONMENTS.includes(environment)) throw new ConfigError("INVALID_OPTION", `integr8Vitest: "environment" must be one of ${ENVIRONMENTS.join(", ")}; got ${String(environment)}.`);
 	if (typeof coverageThreshold !== "number" || !Number.isFinite(coverageThreshold) || coverageThreshold < 0 || coverageThreshold > 100) throw new ConfigError("INVALID_OPTION", `integr8Vitest: "coverageThreshold" must be a number from 0 to 100; got ${String(coverageThreshold)}.`);
+	const setupFiles = copySetupFiles(options.setupFiles);
 	return { test: {
 		environment,
+		exclude: [...configDefaults.exclude, "playground/**"],
+		...setupFiles === void 0 ? {} : { setupFiles },
 		coverage: {
 			provider: "v8",
 			include: ["src/**/*.{ts,tsx}"],
@@ -39,4 +45,13 @@ function integr8Vitest(options = {}) {
 		}
 	} };
 }
+function copySetupFiles(setupFiles) {
+	if (setupFiles === void 0) return;
+	if (isNonEmptyString(setupFiles)) return setupFiles;
+	if (Array.isArray(setupFiles) && setupFiles.length > 0 && setupFiles.every(isNonEmptyString)) return [...setupFiles];
+	throw new ConfigError("INVALID_OPTION", "integr8Vitest: \"setupFiles\" must be a non-empty path or a non-empty list of non-empty paths.");
+}
+function isNonEmptyString(value) {
+	return typeof value === "string" && value.trim() !== "";
+}
 export { ConfigError, integr8Vitest };

package/lefthook/base.yml

@@ -23,6 +23,3 @@ pre-push:
     build:
       priority: 3
       run: npm run build
-    playground-smoke:
-      priority: 4
-      run: npm run playground:smoke --if-present

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integr8-media/config",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Shared tooling presets for every @integr8-media repo: TypeScript, Biome, Vitest, tsdown, Lefthook and size-limit.",
   "license": "MIT",
   "author": "Mina Louis Leon",
@@ -42,8 +42,15 @@
       "types": "./dist/sizeLimit.d.mts",
       "default": "./dist/sizeLimit.mjs"
     },
+    "./registry-site": {
+      "types": "./dist/registrySite.d.mts",
+      "default": "./dist/registrySite.mjs"
+    },
     "./package.json": "./package.json"
   },
+  "bin": {
+    "integr8-registry-site": "./dist/registrySiteBin.mjs"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -55,7 +62,7 @@
     "test:coverage": "vitest run --coverage",
     "build": "tsdown",
     "size": "size-limit",
-    "check:exports": "publint && attw --pack --profile esm-only --entrypoints ./vitest ./tsdown ./size-limit",
+    "check:exports": "publint && attw --pack --profile esm-only --entrypoints ./vitest ./tsdown ./size-limit ./registry-site",
     "docs": "typedoc",
     "prepare": "lefthook install"
   },