@decocms/blocks-cli 7.11.2 → 7.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decocms/blocks-cli",
-  "version": "7.11.2",
+  "version": "7.12.0",
   "type": "module",
   "description": "Deco codegen (generate-blocks, generate-schema, generate-invoke) and Fresh-to-TanStack migration tooling",
   "repository": {
@@ -8,7 +8,7 @@
     "url": "https://github.com/decocms/blocks.git",
     "directory": "packages/blocks-cli"
   },
-  "main": "./scripts/generate-blocks.ts",
+  "main": "./scripts/generate.ts",
   "bin": {
     "deco-migrate": "./scripts/migrate.ts",
     "deco-post-cleanup": "./scripts/migrate-post-cleanup.ts",
@@ -18,16 +18,10 @@
     "deco-migrate-blocks-to-kv": "./scripts/migrate-blocks-to-kv.ts",
     "deco-sync-blocks-to-kv": "./scripts/sync-blocks-to-kv.ts"
   },
+  "//exports": "Deliberately narrow. ./generate is the ONE public module entry (unified orchestrator); ./generate-blocks stays only because @decocms/tanstack's vite plugin tsImports it (readBlockDelta + programmatic generateBlocks) — each surviving entry must name its consumer here. The other scripts remain shipped FILES (the orchestrator spawns them; sites' existing `tsx node_modules/@decocms/blocks-cli/scripts/generate-*.ts` invocations keep working) but are internal implementation details of ./generate, not module subpaths. CLIs are exposed via bin, not exports.",
   "exports": {
-    "./generate-app-schemas": "./scripts/generate-app-schemas.ts",
-    "./generate-blocks": "./scripts/generate-blocks.ts",
-    "./generate-blocks-manifest": "./scripts/generate-blocks-manifest.ts",
-    "./generate-schema": "./scripts/generate-schema.ts",
-    "./generate-invoke": "./scripts/generate-invoke.ts",
-    "./migrate": "./scripts/migrate.ts",
-    "./migrate-post-cleanup": "./scripts/migrate-post-cleanup.ts",
-    "./migrate-to-cf-observability": "./scripts/migrate-to-cf-observability.ts",
-    "./tailwind-lint": "./scripts/tailwind-lint.ts"
+    "./generate": "./scripts/generate.ts",
+    "./generate-blocks": "./scripts/generate-blocks.ts"
   },
   "scripts": {
     "build": "tsc",
@@ -36,7 +30,7 @@
     "lint:unused": "knip"
   },
   "dependencies": {
-    "@decocms/blocks": "7.11.2",
+    "@decocms/blocks": "7.12.0",
     "ts-morph": "^27.0.0",
     "tsx": "^4.22.5"
   },

package/scripts/generate-blocks-manifest.ts

@@ -1,4 +1,9 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented.
+ */
 /**
  * Reads .deco/blocks/*.json and emits blocksManifest.gen.ts — a module that
  * STATICALLY imports every block file and re-exports them as one

package/scripts/generate-blocks.ts

@@ -1,4 +1,12 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented. Exception to the exports-map narrowing: this file keeps
+ * its `@decocms/blocks-cli/generate-blocks` subpath export because
+ * @decocms/tanstack's vite plugin tsImports it (programmatic
+ * generateBlocks on bootstrap, readBlockDelta on live edits).
+ */
 /**
  * Reads .deco/blocks/*.json and emits:
  *   1. blocks.gen.json  — compact JSON data (the source of truth)

package/scripts/generate-invoke.ts

@@ -1,4 +1,9 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented.
+ */
 /**
  * Scans @decocms/apps-vtex's invoke.ts and generates a site-local invoke file
  * with top-level createServerFn declarations.

package/scripts/generate-loaders.ts

@@ -1,4 +1,9 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented.
+ */
 /**
  * Scans site loader and action files and generates a registry map
  * for COMMERCE_LOADERS pass-through entries.

package/scripts/generate-schema.ts

@@ -1,4 +1,9 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented.
+ */
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

package/scripts/generate-sections.ts

@@ -1,4 +1,9 @@
 #!/usr/bin/env tsx
+/**
+ * Internal implementation detail of generate.ts (the unified orchestrator)
+ * -- invoke `generate` instead; direct invocation remains possible but
+ * undocumented.
+ */
 /**
  * Scans site section files and extracts convention-based metadata:
  *   - export const eager = true       → alwaysEager