@platforma-sdk/block-tools 2.14.1 → 2.14.2

package/src/structure/rules/root.ts

@@ -3,11 +3,16 @@
 // skip this whole scope: the parent monorepo owns root files. Hence the
 // `when(({ ctx }) => !ctx.isSdkInternal, ...)` wrapper.
 
-import { scope, when, fixed, managed, file, generate } from "../engine/api";
+import { scope, when, fixed, managed, seed, file, text, generate } from "../engine/api";
 import { rootPackageJsonInitial, rootPackageJsonRules } from "./root-package-json";
 import { rootTurboJsonInitial, rootTurboJsonRules } from "./root-turbo-json";
 import { rootPnpmWorkspaceInitial, rootPnpmWorkspaceRules } from "./root-pnpm-workspace";
 import { rootGitignoreRules } from "./root-gitignore";
+import {
+  rootChangesetConfigInitial,
+  rootChangesetConfigRules,
+  EMPTY_CHANGESET_SEED,
+} from "./root-changeset-config";
 
 export function rootRules(): void {
   scope("root", () => {
@@ -42,6 +47,15 @@ export function rootRules(): void {
         managed(".gitignore", file("root/.gitignore"), () => {
           rootGitignoreRules();
         });
+
+        managed(
+          ".changeset/config.json",
+          generate(() => rootChangesetConfigInitial()),
+          () => {
+            rootChangesetConfigRules();
+          },
+        );
+        seed(".changeset/scaffold.md", text(EMPTY_CHANGESET_SEED));
       },
     );
   });

package/src/structure/rules/shared/initial-version.ts

@@ -0,0 +1,17 @@
+import { transformAt } from "../../engine/api";
+
+/** Seeded at init for every module. `pnpm pack` rewrites the facade's
+ *  `workspace:*` devDeps to concrete ranges, so a versionless sibling breaks
+ *  `do-pack`. Changesets owns the field afterwards. */
+export const INITIAL_MODULE_VERSION = "1.0.0";
+
+/** Backfill `version` on a sibling that has none — a block scaffolded before
+ *  the initials seeded the field keeps its versionless manifests through a
+ *  `structure refresh`, and `do-pack` then dies resolving the facade's
+ *  `workspace:*` deps. Never touches an existing value: past init the field
+ *  belongs to changesets. */
+export function ensureModuleVersion(): void {
+  transformAt<unknown>("version", (current) =>
+    typeof current === "string" && current.length > 0 ? current : INITIAL_MODULE_VERSION,
+  );
+}

package/src/structure/rules/software-package-json.ts

@@ -20,6 +20,7 @@ import {
   type RunContext,
 } from "../engine/api";
 import { canonicalPackageJsonOrder } from "./shared/key-order";
+import { ensureModuleVersion, INITIAL_MODULE_VERSION } from "./shared/initial-version";
 
 // The software-build build/pack commands, shared by the generator and the reconciler. block-tools
 // bundles the build engine, so these are the only build-tool commands a software-build block runs.
@@ -56,6 +57,7 @@ export function softwarePackageJsonInitial(ctx: RunContext): Record<string, unkn
 
   return {
     name: `${v.facadeName}.software`,
+    version: INITIAL_MODULE_VERSION,
     type: "module",
     description: "Block Software",
     files: ["./dist/**/*"],
@@ -80,6 +82,10 @@ export function softwarePackageJsonRules(): void {
   // so a `structure refresh` heals any block that has it.
   removeField("private");
 
+  // A software package publishes, so it must carry a `version`; backfilled when
+  // the manifest predates the seeded field, then owned by changesets.
+  ensureModuleVersion();
+
   ensureField("type", "module");
   ensureField("files", ["./dist/**/*"]);
 

package/src/structure/rules/test-package-json.ts

@@ -13,12 +13,14 @@ import {
   type RunContext,
 } from "../engine/api";
 import { canonicalPackageJsonOrder } from "./shared/key-order";
+import { ensureModuleVersion, INITIAL_MODULE_VERSION } from "./shared/initial-version";
 import { removeRetiredToolchainDeps } from "./shared/retired-deps";
 
 export function testPackageJsonInitial(ctx: RunContext): Record<string, unknown> {
   const v = ctx.blockVars;
   return {
     name: `${v.facadeName}.test`,
+    version: INITIAL_MODULE_VERSION,
     private: true,
     type: "module",
     scripts: {
@@ -42,7 +44,9 @@ export function testPackageJsonInitial(ctx: RunContext): Record<string, unknown>
 export function testPackageJsonRules(): void {
   // Controlled sibling — workspace-only, never published. (The initial already
   // seeds `private: true`; the body re-asserts it. The `version` is kept —
-  // changesets-owned — so the packed template's lib carries a version.)
+  // changesets-owned — so the packed template's lib carries a version, and
+  // backfilled when the manifest predates the seeded field.)
+  ensureModuleVersion();
   ensureField("private", true);
 
   ensureField("type", "module");

package/src/structure/rules/ui-package-json.ts

@@ -25,6 +25,7 @@ import {
 } from "../engine/api";
 import { scopeDepMap } from "../engine/ctx";
 import { canonicalPackageJsonOrder } from "./shared/key-order";
+import { ensureModuleVersion, INITIAL_MODULE_VERSION } from "./shared/initial-version";
 import { COLOCATED_TEST_GLOB } from "./shared/colocated-tests";
 import { removeRetiredToolchainDeps } from "./shared/retired-deps";
 
@@ -32,6 +33,7 @@ export function uiPackageJsonInitial(ctx: RunContext): Record<string, unknown> {
   const v = ctx.blockVars;
   return {
     name: `${v.facadeName}.ui`,
+    version: INITIAL_MODULE_VERSION,
     private: true,
     type: "module",
     scripts: {
@@ -61,7 +63,9 @@ export function uiPackageJsonInitial(ctx: RunContext): Record<string, unknown> {
 
 export function uiPackageJsonRules(): void {
   // Controlled sibling — workspace-only, never published, but kept versioned
-  // (changesets-owned) so the packed template's lib carries a version.
+  // (changesets-owned) so the packed template's lib carries a version —
+  // backfilled when the manifest predates the seeded field.
+  ensureModuleVersion();
   ensureField("private", true);
 
   ensureField("type", "module");

package/src/structure/rules/workflow-package-json.ts

@@ -18,6 +18,7 @@ import {
 } from "../engine/api";
 import { scopeDepMaps } from "../engine/ctx";
 import { canonicalPackageJsonOrder } from "./shared/key-order";
+import { ensureModuleVersion, INITIAL_MODULE_VERSION } from "./shared/initial-version";
 import { COLOCATED_TEST_GLOB } from "./shared/colocated-tests";
 import { removeRetiredToolchainDeps } from "./shared/retired-deps";
 
@@ -25,6 +26,7 @@ export function workflowPackageJsonInitial(ctx: RunContext): Record<string, unkn
   const v = ctx.blockVars;
   return {
     name: `${v.facadeName}.workflow`,
+    version: INITIAL_MODULE_VERSION,
     private: true,
     type: "module",
     scripts: {
@@ -55,7 +57,9 @@ export function workflowPackageJsonInitial(ctx: RunContext): Record<string, unkn
 
 export function workflowPackageJsonRules(): void {
   // Controlled sibling — workspace-only, never published, but kept versioned
-  // (changesets-owned) so the packed template's lib carries a version.
+  // (changesets-owned) so the packed template's lib carries a version —
+  // backfilled when the manifest predates the seeded field.
+  ensureModuleVersion();
   ensureField("private", true);
 
   ensureField("type", "module");

package/src/structure/templates/text/model/src/index.tpl.ts

@@ -11,7 +11,7 @@ const dataModel = new DataModelBuilder({ kind })
 
 export const platforma = BlockModelV3.create({ dataModel, kind })
   .args(() => ({}))
-  .templateParams((data) => ({}))
+  .templateParams(() => ({}))
   .sections(() => [{ type: "link", href: "/", label: "Main" }])
   .done();
 

package/src/structure/templates/text/workflows/build.tpl.yaml

@@ -24,7 +24,7 @@ jobs:
     with:
       app-name: '${appName}'
       app-name-slug: '${appNameSlug}'
-      node-version: '20.x'
+      node-version: '22.x'
       gha-runner-label: hz-ubuntu-dind
       build-script-name: 'build:dev-local'
       build-before-publish-script-name: 'build:release'

package/src/structure/templates/text/workflows/mark-stable.tpl.yaml

@@ -15,7 +15,7 @@ jobs:
     uses: milaboratory/github-ci/.github/workflows/block-mark-stable.yaml@v4
     with:
       app-name: '${appName}'
-      node-version: '20.x'
+      node-version: '22.x'
       npmrc-config: |
         {
           "registries": {