@jterrazz/test 13.0.0 → 13.0.2

package/dist/index.d.ts

@@ -1637,17 +1637,18 @@ interface CliSpecificationOptions<Services extends ServiceRecord = ServiceRecord
    */
   docker?: DockerSpecConfig;
   /**
-   * Named environment SETS for literate `.cli` specs. A header line
-   * `env: frozen` applies the whole `frozen` record; `$WORKDIR` expands and
-   * `null` unsets, exactly as in `.env()`. Declared once per app so a
-   * scenario file states WHICH ground it stands on, not how to build it.
+   * Named environment SETS for `<case>.spec.yaml` documents. An `env:` entry
+   * `frozen` applies the whole `frozen` record; `$WORKDIR` expands and `null`
+   * unsets, exactly as in `.env()`. Declared once per app so a document
+   * states WHICH ground it stands on, not how to build it.
    */
   env?: Record<string, CliEnv>;
   /**
-   * Named servers a literate `.cli` header may start (`serve: mcp KEY=value`).
-   * Each entry names the shell `command`, the `ready` regex whose capture
-   * group holds the port the server announces, the `url(port)` builder, and
-   * the `env` variable that URL is bound to in every block's child.
+   * Named servers a `<case>.spec.yaml` document may start (`serve: [mcp]`, or
+   * `- mcp: { KEY: value }` to add env to that one). Each entry names the
+   * shell `command`, the `ready` regex whose capture group holds the port the
+   * server announces, the `url(port)` builder, and the `env` variable that
+   * URL is bound to in every run's child.
    */
   serve?: Record<string, LiterateServeRegistration>;
   /**

package/dist/spec-document.js

@@ -16,11 +16,51 @@ function detectIndent(text) {
 	}
 	return smallest === 0 ? 2 : smallest;
 }
+/** The tag every string goes out through — key, plain value and block scalar alike. */
+const STRING_TAG = "tag:yaml.org,2002:str";
+/** An indentation indicator is ONE digit, so nine spaces is the deepest step statable. */
+const DEEPEST_STATABLE_STEP = 9;
+/**
+* Restate a block scalar's indentation indicator from the indentation its
+* content is actually written at.
+*
+* A block scalar whose first line opens on a space NEEDS that indicator: without
+* it a reader takes the space for indentation and gives back a string shorter
+* than the one that was written. The `yaml` writer knows when one is called for
+* and adds it — but it always writes the digit `2`, its own default step, never
+* the step it was asked to indent with. In a four-space document (oxfmt formats
+* YAML at four) `|2` puts every line back two spaces short, so the golden update
+* mode just wrote fails on its very next run.
+*
+* The digit belongs to the block, not to the writer's default: content sits one
+* step below its key, so the file's step is what the indicator names — and `1`
+* at the root, which YAML counts from -1.
+*/
+function stateIndentation(written, ctx) {
+	if (!/^[|>][1-9]/.test(written)) return written;
+	const step = ctx.indent === "" ? 1 : ctx.indentStep.length;
+	if (step > DEEPEST_STATABLE_STEP) throw new Error(`A block scalar indented by ${step} spaces cannot state its indentation: YAML writes that indicator as a single digit, so ${DEEPEST_STATABLE_STEP} spaces is the deepest step a document may be written with.`);
+	return `${written[0]}${step}${written.slice(2)}`;
+}
+/** A scalar tag among the schema's, told from a collection one by what it may hold. */
+function isScalarTag(tag) {
+	return typeof tag !== "string" && tag.collection === void 0;
+}
+/** The string tag, wrapped so every block scalar it writes states its own indentation. */
+function statingItsIndentation(tag) {
+	const write = tag.stringify;
+	if (write === void 0) return tag;
+	return {
+		...tag,
+		stringify: (item, ctx, onComment, onChompKeep) => stateIndentation(write(item, ctx, onComment, onChompKeep), ctx)
+	};
+}
 /** Parse a YAML file into its document form, keeping comments and key order. */
 function parseYamlSource(text) {
 	const lineCounter = new LineCounter();
 	return {
 		document: parseDocument(text, {
+			customTags: (tags) => tags.map((tag) => isScalarTag(tag) && tag.tag === STRING_TAG ? statingItsIndentation(tag) : tag),
 			keepSourceTokens: true,
 			lineCounter
 		}),
@@ -38,8 +78,10 @@ function yamlSyntaxErrors(source) {
 /**
 * A literal block scalar. The `yaml` writer picks the chomping indicator from
 * the value itself — `|` when the text ends with a newline, `|-` when it does
-* not — and adds the indentation indicator (`|2`) when the first line starts
-* with a space, which is exactly the byte-exactness the format promises.
+* not — and decides whether an indentation indicator is called for, which is
+* when the first line opens on a space. What that indicator SAYS is restated on
+* the way out by `stateIndentation` above, and together the two are the
+* byte-exactness the format promises.
 */
 function blockScalar(text) {
 	const scalar = new Scalar(text);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jterrazz/test",
-    "version": "13.0.0",
+    "version": "13.0.2",
     "description": "Declarative testing framework for HTTP APIs, CLIs, and background jobs — one entry point, real infrastructure, golden-file assertions, plus an oxlint convention plugin.",
     "keywords": [
         "api-testing",