js-yaml 4.1.0: loadAll

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify js-yaml.loadAll in pkg:npm/js-yaml@4.1.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/js-yaml@4.1.0
Demonstrate these symbols/APIs:
  - js-yaml.loadAll

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:8a9978454fbaa924384b6a9b7dddad00ff2afb4e616dcf43c3e690b384362ed6","contract":["yaml.loadAll parses multiple documents separated by --- without iterator and returns an array of documents","yaml.loadAll invokes iterator callback once for each document in multi-document string","yaml.loadAll parses documents containing scalars, arrays, nested maps, and null/boolean values across documents","yaml.loadAll handles document stream with explicit document-end marker ... and leading/trailing separators","yaml.loadAll respects options such as schema FAILSAFE_SCHEMA to parse all values as strings","yaml.loadAll handles single document strings by returning a single-element array","yaml.loadAll throws YAMLException when any document in the stream has invalid YAML syntax"],"goal":"verify js-yaml.loadAll in pkg:npm/js-yaml@4.1.0","kind":"HOW","packages":["pkg:npm/js-yaml@4.1.0"],"schemaVersion":1,"symbols":["js-yaml.loadAll"]},"contractCommand":["node","test/contract.cjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/js-yaml@4.1.0"],"schemaVersion":1,"subject":"pkg:npm/js-yaml@4.1.0","symbols":["js-yaml.loadAll"],"verifierAdapter":"node-typescript@1"}

{
  "name": "js-yaml-loadall-verification",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "js-yaml-loadall-verification",
      "version": "1.0.0",
      "dependencies": {
        "js-yaml": "4.1.0"
      }
    },
    "node_modules/argparse": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
      "license": "Python-2.0"
    },
    "node_modules/js-yaml": {
      "version": "4.1.0",
      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
      "license": "MIT",
      "dependencies": {
        "argparse": "^2.0.1"
      },
      "bin": {
        "js-yaml": "bin/js-yaml.js"
      }
    }
  }
}

{
  "name": "js-yaml-loadall-verification",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification for js-yaml.loadAll",
  "dependencies": {
    "js-yaml": "4.1.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify js-yaml.loadAll in pkg:npm/js-yaml@4.1.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/js-yaml@4.1.0"
  ],
  "symbols": [
    "js-yaml.loadAll"
  ]
}

const assert = require('node:assert');
const yaml = require('js-yaml');

// 1. yaml.loadAll parses multiple documents separated by --- without iterator and returns an array of documents
const multiDoc = `
---
name: doc1
kind: Service
---
name: doc2
kind: Deployment
`;
const parsedDocs = yaml.loadAll(multiDoc);
assert.strictEqual(Array.isArray(parsedDocs), true);
assert.strictEqual(parsedDocs.length, 2);
assert.deepStrictEqual(parsedDocs[0], { name: 'doc1', kind: 'Service' });
assert.deepStrictEqual(parsedDocs[1], { name: 'doc2', kind: 'Deployment' });

// 2. yaml.loadAll invokes iterator callback once for each document in multi-document string
const iteratorDocs = [];
const ret = yaml.loadAll(multiDoc, (doc) => {
  iteratorDocs.push(doc);
});
assert.strictEqual(ret, undefined);
assert.deepStrictEqual(iteratorDocs, [
  { name: 'doc1', kind: 'Service' },
  { name: 'doc2', kind: 'Deployment' }
]);

// 3. yaml.loadAll parses documents containing scalars, arrays, nested maps, and null/boolean values across documents
const complexDoc = `
---
scalar: hello
numbers:
  - 10
  - 20.5
---
isActive: true
nilVal: null
nested:
  child: value
`;
const complexParsed = yaml.loadAll(complexDoc);
assert.strictEqual(complexParsed.length, 2);
assert.deepStrictEqual(complexParsed[0], {
  scalar: 'hello',
  numbers: [10, 20.5]
});
assert.deepStrictEqual(complexParsed[1], {
  isActive: true,
  nilVal: null,
  nested: { child: 'value' }
});

// 4. yaml.loadAll handles document stream with explicit document-end marker ... and leading/trailing separators
const streamDoc = `
---
doc: first
...
---
doc: second
...
`;
const streamParsed = yaml.loadAll(streamDoc);
assert.deepStrictEqual(streamParsed, [{ doc: 'first' }, { doc: 'second' }]);

// 5. yaml.loadAll respects options such as schema FAILSAFE_SCHEMA to parse all values as strings
const optionsDoc = `
---
num: 123
---
flag: true
`;
const failsafeParsed = yaml.loadAll(optionsDoc, { schema: yaml.FAILSAFE_SCHEMA });
assert.deepStrictEqual(failsafeParsed, [
  { num: '123' },
  { flag: 'true' }
]);

// 6. yaml.loadAll handles single document strings by returning a single-element array
const singleDoc = "single: document\nvalue: 42\n";
const singleParsed = yaml.loadAll(singleDoc);
assert.deepStrictEqual(singleParsed, [{ single: 'document', value: 42 }]);

// 7. yaml.loadAll throws YAMLException when any document in the stream has invalid YAML syntax
assert.throws(() => {
  yaml.loadAll(`
---
valid: ok
---
invalid: [broken
`);
}, yaml.YAMLException);

console.log('Contract passed');