@platforma-sdk/block-tools 2.10.19 → 2.11.0

package/dist/structure/engine/builders.d.ts

@@ -82,12 +82,13 @@ export declare function binaryFile(path: string): ContentForm;
 /** Content form: an inline literal string. */
 export declare function text(value: string): ContentForm;
 /** Content form: a text template (the structurer's `text/` templates) with
- *  `${var}` placeholders substituted from `vars`. */
-export declare function tpl(path: string, vars: Record<string, string> | (() => Record<string, string>)): ContentForm;
-/** Content form: content computed at run time. The return value is serialised
- *  as JSON / YAML by the target file's extension, or used verbatim if it is
- *  already a string. */
-export declare function generate(fn: () => unknown): ContentForm;
+ *  `${var}` placeholders substituted from `vars`. When `vars` is a function it
+ *  receives the active {@link RunContext} at resolve time. */
+export declare function tpl(path: string, vars: Record<string, string> | ((ctx: RunContext) => Record<string, string>)): ContentForm;
+/** Content form: content computed at run time from the active
+ *  {@link RunContext}. The return value is serialised as JSON / YAML by the
+ *  target file's extension, or used verbatim if it is already a string. */
+export declare function generate(fn: (ctx: RunContext) => unknown): ContentForm;
 /** The active run's {@link BlockVars} (block name parts + software platform).
  *  Valid only during a run (inside a generator or managed body); throws
  *  otherwise. */

package/dist/structure/engine/content-rules.d.ts

@@ -1,5 +1,5 @@
 import { RunContext, Scope } from './api';
-import { TriggerContext } from './ir';
+import { ManagedBody, TriggerContext } from './ir';
 import { JsonObject } from './parsers/json';
 import { YamlDocument } from './parsers/yaml';
 export type { JsonObject };
@@ -30,7 +30,7 @@ export type WithManagedOpts = {
 /** Engine-internal: run `body` with `obj` as the active JSON state so the
  *  JSON builders mutate it; returns the mutated object. Exported for tests —
  *  the runner calls this for managed `.json` files. */
-export declare function withManagedBody(obj: JsonObject, body: () => void, opts?: WithManagedOpts): JsonObject;
+export declare function withManagedBody(obj: JsonObject, body: ManagedBody, opts?: WithManagedOpts): JsonObject;
 export type WithManagedYamlOpts = WithManagedOpts & {
     /** Sync accessor for prefetched latest versions. Required for
      *  `ensureCatalogLatest` to take effect. */
@@ -41,10 +41,10 @@ export type WithManagedYamlOpts = WithManagedOpts & {
 };
 /** Engine-internal: run `body` with `doc` as the active YAML state (for
  *  `pnpm-workspace.yaml`); returns the mutated document. Exported for tests. */
-export declare function withManagedYaml(doc: YamlDocument, body: () => void, opts?: WithManagedYamlOpts): YamlDocument;
+export declare function withManagedYaml(doc: YamlDocument, body: ManagedBody, opts?: WithManagedYamlOpts): YamlDocument;
 /** Engine-internal: run `body` with `lines` as the active line-based state
  *  (for `.gitignore`); returns the mutated lines. Exported for tests. */
-export declare function withManagedLines(lines: string[], body: () => void, opts?: WithManagedOpts): string[];
+export declare function withManagedLines(lines: string[], body: ManagedBody, opts?: WithManagedOpts): string[];
 /** Set the value at `jsonPath` in the active managed JSON object. */
 export declare function ensureField(jsonPath: string, value: unknown): void;
 /** Remove the field at `jsonPath`. With `predicate`, only removes when

package/dist/structure/engine/ir.d.ts

@@ -24,9 +24,11 @@ export type TriggerContext = {
 };
 export type TriggerFn = (tctx: TriggerContext) => boolean;
 /** Content forms — what to write into a file when creating it.
- *  `tpl.vars` may be a record or a thunk returning a record; the latter
- *  lets rule authors call `blockVars()` lazily at resolve time. */
-export type TplVarsLike = Record<string, string> | (() => Record<string, string>);
+ *  `tpl.vars` and `generate.fn` may be functions; when they are, the
+ *  resolver calls them with the active `RunContext` (the same object
+ *  triggers see as `tctx.ctx`), so lambdas read block identity via their
+ *  argument rather than the module-global `getActiveRunContext()`. */
+export type TplVarsLike = Record<string, string> | ((ctx: RunContext) => Record<string, string>);
 export type ContentForm = {
     kind: "file";
     path: string;
@@ -39,13 +41,16 @@ export type ContentForm = {
     vars: TplVarsLike;
 } | {
     kind: "generate";
-    fn: () => unknown;
+    fn: (ctx: RunContext) => unknown;
 } | {
     kind: "binary";
     path: string;
 };
-/** Builder-body for a `managed` file (the content-rules lambda). */
-export type ManagedBody = () => void;
+/** Builder-body for a `managed` file (the content-rules lambda). Receives the
+ *  active `RunContext` — the same object triggers see as `tctx.ctx` and that
+ *  `generate`/`tpl` lambdas receive — so the body reads block identity via its
+ *  argument rather than the module-global `getActiveRunContext()`. */
+export type ManagedBody = (ctx: RunContext) => void;
 export type FixedItem = {
     kind: "fixed";
     path: string;

package/dist/structure/rules/block-package-json.d.ts

@@ -6,4 +6,4 @@ import { RunContext } from '../engine/api';
  *  workflow → pl-tengo, model → build-model, ui → ts-builder. */
 export declare function blockComponents(ctx: RunContext): Record<string, string>;
 export declare function blockPackageJsonInitial(ctx: RunContext): Record<string, unknown>;
-export declare function blockPackageJsonRules(): void;
+export declare function blockPackageJsonRules(ctx: RunContext): void;

package/dist/structure/rules/root-ci.d.ts

@@ -0,0 +1 @@
+export declare function rootCiRules(): void;