@stardeck-customer-apps/compose 0.10.0 → 0.12.0

package/SKILL.md

@@ -23,6 +23,12 @@ Compose turns that declaration into the code Next.js actually builds:
   kept Module's `enhancements/<excluded>/`. Their source stays on disk but their
   stubs are gone, so `next build` must type-check through this file
   (`typescript.tsconfigPath` in `next.config.ts`), never through `tsconfig.json`.
+  It also skips test-only files (`*.test.ts(x)`, `*.spec.ts(x)`, `__tests__/`,
+  `test-utils/`, `test-helpers.ts`, Module `tests/` and `e2e/` folders, the
+  app's `e2e/`, `tests/`, `scripts/`, and the vitest/playwright configs), which
+  halves a Blueprint's deploy type-check. `npm run typecheck` still covers them
+  through `tsconfig.json`, so keep running it. A skipped file the app does
+  import is still type-checked through that import.
   Gitignore it; do not hand-maintain an exclude list.
 
 ## Running it
@@ -75,7 +81,9 @@ a silent fallback. It holds deployment facts: gitignore it (`apps/web/.gitignore
   installed Module. Library and contract Modules are always composed. A name
   that is not installed fails with exit 1. Falls back to
   `NEXT_PUBLIC_STARDECK_ENABLED_MODULES` (how the platform passes the selection
-  at deploy time); the flag wins.
+  at deploy time); the flag wins. A Module whose `module.json` sets
+  `"defaultEnabled": false` is still composed when `--enabled` is unset: the key
+  only tells the platform to leave it off when it creates a Blueprint fork.
 - `--prune` — after composing, delete the source of every excluded Module, plus
   any enhancement slice an enabled Module keeps for an excluded peer (the slice
   imports its peer, so leaving it breaks `next build`). Requires `--enabled`,

package/dist/cli.js

@@ -2354,7 +2354,13 @@ var moduleManifestSchema = import_zod.z.object({
    * `module-boundaries/ui-layer` lint rule enforces it — so a fork may
    * soft-eject them. See docs/module-ui-soft-eject-plan.md.
    */
-  ui: import_zod.z.object({ separable: import_zod.z.boolean() }).strict().optional()
+  ui: import_zod.z.object({ separable: import_zod.z.boolean() }).strict().optional(),
+  /**
+   * `false` keeps a feature Module off in a new Blueprint fork unless the
+   * creator ticks it: the fork picker leaves it unchecked and "every Module"
+   * is written out without it. Omitted means on. Library Modules are always on.
+   */
+  defaultEnabled: import_zod.z.boolean().optional()
 }).strict().superRefine((manifest, ctx) => {
   if (manifest.uses.includes(manifest.name)) {
     ctx.addIssue({
@@ -3889,6 +3895,7 @@ function analyzeClientSafeEntryImports(sourceText, fileName) {
 
 // ../../packages/lib/src/shared/platform-owned-paths.ts
 var APP_WEB_PREFIX = "apps/web/";
+var BLUEPRINT_LINT_MARKER = `${APP_WEB_PREFIX}eslint-rules/module-boundaries.mjs`;
 var MODULE_STUB_MARKER = "@stardeck-module-rail-generated";
 var ENABLED_MODULES_ENV = "NEXT_PUBLIC_STARDECK_ENABLED_MODULES";
 var HEADLESS_MOUNTS_ENV = "NEXT_PUBLIC_STARDECK_HEADLESS_MOUNTS";
@@ -5935,10 +5942,12 @@ var creationSourceBlueprintSchema = import_zod7.z.object({
   /** Internal template/fork project id — keep template naming in identifiers. */
   blueprintProjectId: import_zod7.z.string().uuid(),
   /**
-   * `null`/absent means every feature Module. `[]` is refused: the platform
-   * serialises it to an empty `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the
-   * enablement parser reads back as "all" (`module-enablement.ts`) — the
-   * opposite of what an empty selection means.
+   * `null`/absent means every feature Module: the platform stores that as the
+   * explicit list of feature Modules in the published Blueprint version the fork
+   * is cut from, so a Module a later Blueprint update adds arrives off. `[]` is
+   * refused: the platform serialises it to an empty
+   * `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the enablement parser reads
+   * back as "all" (`module-enablement.ts`) — the opposite of an empty selection.
    */
   enabledModules: import_zod7.z.array(moduleNameSchema).min(1, "Enable at least one Module").max(100).nullable().optional()
 });
@@ -7707,6 +7716,24 @@ function assertNoAppLayerImporters(cwd, excluded) {
 var TSCONFIG_PATH = "apps/web/tsconfig.json";
 var BUILD_TSCONFIG_PATH = "apps/web/tsconfig.build.gen.json";
 var BUILD_TSCONFIG_HEADER = "// Generated by stardeck-compose \u2014 the tsconfig `next build` type-checks. Do not edit or commit.";
+var BUILD_TYPECHECK_SKIP = [
+  "**/*.test.ts",
+  "**/*.test.tsx",
+  "**/*.spec.ts",
+  "**/*.spec.tsx",
+  "**/__tests__",
+  "**/test-utils",
+  "**/test-helpers.ts",
+  // Module test suites, including those inside enhancement slices.
+  "src/modules/**/tests",
+  "src/modules/**/e2e",
+  "e2e",
+  "tests",
+  "scripts",
+  "vitest.config.ts",
+  "vitest.setup.ts",
+  "playwright.config.ts"
+];
 function writeBuildTsconfig(cwd, excluded) {
   const baseFile = import_node_path3.default.join(cwd, TSCONFIG_PATH);
   if (!import_node_fs3.default.existsSync(import_node_path3.default.join(cwd, MODULES_DIR2)) || !import_node_fs3.default.existsSync(baseFile)) return;
@@ -7722,6 +7749,7 @@ function writeBuildTsconfig(cwd, excluded) {
     extends: "./tsconfig.json",
     exclude: [
       ...baseExclude,
+      ...BUILD_TYPECHECK_SKIP,
       ...excluded.flatMap((name) => [
         `${modulesDir}/${name}`,
         `${modulesDir}/*/enhancements/${name}`

package/dist/index.js

@@ -2476,7 +2476,13 @@ var moduleManifestSchema = import_zod2.z.object({
    * `module-boundaries/ui-layer` lint rule enforces it — so a fork may
    * soft-eject them. See docs/module-ui-soft-eject-plan.md.
    */
-  ui: import_zod2.z.object({ separable: import_zod2.z.boolean() }).strict().optional()
+  ui: import_zod2.z.object({ separable: import_zod2.z.boolean() }).strict().optional(),
+  /**
+   * `false` keeps a feature Module off in a new Blueprint fork unless the
+   * creator ticks it: the fork picker leaves it unchecked and "every Module"
+   * is written out without it. Omitted means on. Library Modules are always on.
+   */
+  defaultEnabled: import_zod2.z.boolean().optional()
 }).strict().superRefine((manifest, ctx) => {
   if (manifest.uses.includes(manifest.name)) {
     ctx.addIssue({
@@ -4011,6 +4017,7 @@ function analyzeClientSafeEntryImports(sourceText, fileName) {
 
 // ../../packages/lib/src/shared/platform-owned-paths.ts
 var APP_WEB_PREFIX = "apps/web/";
+var BLUEPRINT_LINT_MARKER = `${APP_WEB_PREFIX}eslint-rules/module-boundaries.mjs`;
 var MODULE_STUB_MARKER = "@stardeck-module-rail-generated";
 var ENABLED_MODULES_ENV = "NEXT_PUBLIC_STARDECK_ENABLED_MODULES";
 var HEADLESS_MOUNTS_ENV = "NEXT_PUBLIC_STARDECK_HEADLESS_MOUNTS";
@@ -5945,10 +5952,12 @@ var creationSourceBlueprintSchema = import_zod7.z.object({
   /** Internal template/fork project id — keep template naming in identifiers. */
   blueprintProjectId: import_zod7.z.string().uuid(),
   /**
-   * `null`/absent means every feature Module. `[]` is refused: the platform
-   * serialises it to an empty `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the
-   * enablement parser reads back as "all" (`module-enablement.ts`) — the
-   * opposite of what an empty selection means.
+   * `null`/absent means every feature Module: the platform stores that as the
+   * explicit list of feature Modules in the published Blueprint version the fork
+   * is cut from, so a Module a later Blueprint update adds arrives off. `[]` is
+   * refused: the platform serialises it to an empty
+   * `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the enablement parser reads
+   * back as "all" (`module-enablement.ts`) — the opposite of an empty selection.
    */
   enabledModules: import_zod7.z.array(moduleNameSchema).min(1, "Enable at least one Module").max(100).nullable().optional()
 });
@@ -7717,6 +7726,24 @@ function assertNoAppLayerImporters(cwd, excluded) {
 var TSCONFIG_PATH = "apps/web/tsconfig.json";
 var BUILD_TSCONFIG_PATH = "apps/web/tsconfig.build.gen.json";
 var BUILD_TSCONFIG_HEADER = "// Generated by stardeck-compose \u2014 the tsconfig `next build` type-checks. Do not edit or commit.";
+var BUILD_TYPECHECK_SKIP = [
+  "**/*.test.ts",
+  "**/*.test.tsx",
+  "**/*.spec.ts",
+  "**/*.spec.tsx",
+  "**/__tests__",
+  "**/test-utils",
+  "**/test-helpers.ts",
+  // Module test suites, including those inside enhancement slices.
+  "src/modules/**/tests",
+  "src/modules/**/e2e",
+  "e2e",
+  "tests",
+  "scripts",
+  "vitest.config.ts",
+  "vitest.setup.ts",
+  "playwright.config.ts"
+];
 function writeBuildTsconfig(cwd, excluded) {
   const baseFile = import_node_path3.default.join(cwd, TSCONFIG_PATH);
   if (!import_node_fs3.default.existsSync(import_node_path3.default.join(cwd, MODULES_DIR2)) || !import_node_fs3.default.existsSync(baseFile)) return;
@@ -7732,6 +7759,7 @@ function writeBuildTsconfig(cwd, excluded) {
     extends: "./tsconfig.json",
     exclude: [
       ...baseExclude,
+      ...BUILD_TYPECHECK_SKIP,
       ...excluded.flatMap((name) => [
         `${modulesDir}/${name}`,
         `${modulesDir}/*/enhancements/${name}`

package/dist/index.mjs

@@ -2457,7 +2457,13 @@ var moduleManifestSchema = z2.object({
    * `module-boundaries/ui-layer` lint rule enforces it — so a fork may
    * soft-eject them. See docs/module-ui-soft-eject-plan.md.
    */
-  ui: z2.object({ separable: z2.boolean() }).strict().optional()
+  ui: z2.object({ separable: z2.boolean() }).strict().optional(),
+  /**
+   * `false` keeps a feature Module off in a new Blueprint fork unless the
+   * creator ticks it: the fork picker leaves it unchecked and "every Module"
+   * is written out without it. Omitted means on. Library Modules are always on.
+   */
+  defaultEnabled: z2.boolean().optional()
 }).strict().superRefine((manifest, ctx) => {
   if (manifest.uses.includes(manifest.name)) {
     ctx.addIssue({
@@ -3992,6 +3998,7 @@ function analyzeClientSafeEntryImports(sourceText, fileName) {
 
 // ../../packages/lib/src/shared/platform-owned-paths.ts
 var APP_WEB_PREFIX = "apps/web/";
+var BLUEPRINT_LINT_MARKER = `${APP_WEB_PREFIX}eslint-rules/module-boundaries.mjs`;
 var MODULE_STUB_MARKER = "@stardeck-module-rail-generated";
 var ENABLED_MODULES_ENV = "NEXT_PUBLIC_STARDECK_ENABLED_MODULES";
 var HEADLESS_MOUNTS_ENV = "NEXT_PUBLIC_STARDECK_HEADLESS_MOUNTS";
@@ -5926,10 +5933,12 @@ var creationSourceBlueprintSchema = z7.object({
   /** Internal template/fork project id — keep template naming in identifiers. */
   blueprintProjectId: z7.string().uuid(),
   /**
-   * `null`/absent means every feature Module. `[]` is refused: the platform
-   * serialises it to an empty `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the
-   * enablement parser reads back as "all" (`module-enablement.ts`) — the
-   * opposite of what an empty selection means.
+   * `null`/absent means every feature Module: the platform stores that as the
+   * explicit list of feature Modules in the published Blueprint version the fork
+   * is cut from, so a Module a later Blueprint update adds arrives off. `[]` is
+   * refused: the platform serialises it to an empty
+   * `NEXT_PUBLIC_STARDECK_ENABLED_MODULES`, which the enablement parser reads
+   * back as "all" (`module-enablement.ts`) — the opposite of an empty selection.
    */
   enabledModules: z7.array(moduleNameSchema).min(1, "Enable at least one Module").max(100).nullable().optional()
 });
@@ -7698,6 +7707,24 @@ function assertNoAppLayerImporters(cwd, excluded) {
 var TSCONFIG_PATH = "apps/web/tsconfig.json";
 var BUILD_TSCONFIG_PATH = "apps/web/tsconfig.build.gen.json";
 var BUILD_TSCONFIG_HEADER = "// Generated by stardeck-compose \u2014 the tsconfig `next build` type-checks. Do not edit or commit.";
+var BUILD_TYPECHECK_SKIP = [
+  "**/*.test.ts",
+  "**/*.test.tsx",
+  "**/*.spec.ts",
+  "**/*.spec.tsx",
+  "**/__tests__",
+  "**/test-utils",
+  "**/test-helpers.ts",
+  // Module test suites, including those inside enhancement slices.
+  "src/modules/**/tests",
+  "src/modules/**/e2e",
+  "e2e",
+  "tests",
+  "scripts",
+  "vitest.config.ts",
+  "vitest.setup.ts",
+  "playwright.config.ts"
+];
 function writeBuildTsconfig(cwd, excluded) {
   const baseFile = path3.join(cwd, TSCONFIG_PATH);
   if (!fs3.existsSync(path3.join(cwd, MODULES_DIR2)) || !fs3.existsSync(baseFile)) return;
@@ -7713,6 +7740,7 @@ function writeBuildTsconfig(cwd, excluded) {
     extends: "./tsconfig.json",
     exclude: [
       ...baseExclude,
+      ...BUILD_TYPECHECK_SKIP,
       ...excluded.flatMap((name) => [
         `${modulesDir}/${name}`,
         `${modulesDir}/*/enhancements/${name}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stardeck-customer-apps/compose",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Regenerates a Stardeck app's Module-rail artifacts — the six src/*.gen.ts registries and every route/endpoint stub — from src/modules/*/module.json",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,9 +33,9 @@
   "scripts": {
     "build": "rm -rf dist && tsup",
     "dev": "tsup --watch",
-    "format": "prettier --write . && eslint . --fix",
+    "format": "prettier --write . && oxlint . --fix",
     "typecheck": "tsc -p tsconfig.test.json",
-    "lint": "eslint src/",
+    "lint": "oxlint src/",
     "test": "vitest run",
     "test:watch": "vitest"
   },
@@ -54,12 +54,10 @@
     "typescript": ">=5.0.0 <7"
   },
   "devDependencies": {
-    "@eslint/js": "^9.0.0",
     "@stardeck-customer-apps/tsconfig": "*",
     "@types/node": "^24.10.1",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "typescript-eslint": "^8.0.0",
     "vitest": "^3.2.4"
   }
 }