react-is 19.2.8: SuspenseList

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 react-is.SuspenseList in pkg:npm/react-is@19.2.8
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/react-is@19.2.8
Demonstrate these symbols/APIs:
  - react-is.SuspenseList

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:8878e502bce8e99b3e90b00f2ea8095822c2ce7b1d88384cf045df8c205676ce","contract":["react-is exports SuspenseList matching Symbol.for('react.suspense_list')","isValidElementType identifies SuspenseList as a valid React element type","isSuspenseList detects valid React 19 SuspenseList transitional elements","isSuspenseList returns false for SuspenseList symbol itself, legacy elements, non-suspense-list elements, and primitives","typeOf returns SuspenseList symbol for valid suspense-list elements and undefined for non-elements or raw symbols"],"goal":"verify react-is.SuspenseList in pkg:npm/react-is@19.2.8","kind":"HOW","packages":["pkg:npm/react-is@19.2.8"],"schemaVersion":1,"symbols":["react-is.SuspenseList"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/react-is@19.2.8"],"schemaVersion":1,"subject":"pkg:npm/react-is@19.2.8","symbols":["react-is.SuspenseList"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-react-is-suspense-list",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-react-is-suspense-list",
      "version": "1.0.0",
      "dependencies": {
        "react-is": "19.2.8"
      }
    },
    "node_modules/react-is": {
      "version": "19.2.8",
      "resolved": "https://registry.npmjs.org/react-is/-/react-is-19.2.8.tgz",
      "integrity": "sha512-s5un28nYxKJw5gvUHyW5PCC28CvBqLu9r3cWgzHT4Vo/5fqqkFcdRYsGcKf50WMPpjjFZS5d76fn3YCo2njKwQ==",
      "license": "MIT"
    }
  }
}

{
  "name": "sample-react-is-suspense-list",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification of react-is.SuspenseList in React 19",
  "type": "module",
  "main": "src/index.js",
  "dependencies": {
    "react-is": "19.2.8"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify react-is.SuspenseList in pkg:npm/react-is@19.2.8",
  "kind": "HOW",
  "packages": [
    "pkg:npm/react-is@19.2.8"
  ],
  "symbols": [
    "react-is.SuspenseList"
  ]
}

import {
  SuspenseList,
  isSuspenseList,
  typeOf,
  isValidElementType,
  Element,
} from 'react-is';

export { SuspenseList, isSuspenseList, typeOf, isValidElementType, Element };

/**
 * Creates a React 19 element representation.
 *
 * @param {*} type - The element type.
 * @param {Object} [props={}] - Element properties.
 * @returns {Object} React element object.
 */
export function createElement(type, props = {}) {
  return {
    $$typeof: Element || Symbol.for('react.transitional.element'),
    type,
    props,
    key: null,
    ref: null,
  };
}

/**
 * Creates a React 19 SuspenseList element representation.
 *
 * @param {Object} [props={}] - Properties for SuspenseList.
 * @returns {Object} React SuspenseList element object.
 */
export function createSuspenseListElement(props = {}) {
  return createElement(SuspenseList, props);
}

/**
 * Checks whether a given object is a React SuspenseList element.
 *
 * @param {*} value - The value to test.
 * @returns {boolean} True if the value is a SuspenseList element.
 */
export function checkIsSuspenseList(value) {
  return isSuspenseList(value);
}

/**
 * Checks whether a given type is a valid React element type.
 *
 * @param {*} type - The type to test.
 * @returns {boolean} True if the type is valid.
 */
export function checkIsValidElementType(type) {
  return isValidElementType(type);
}

/**
 * Inspects the React type of a given value.
 *
 * @param {*} value - The value to inspect.
 * @returns {*|undefined} Type symbol or undefined.
 */
export function inspectTypeOf(value) {
  return typeOf(value);
}

import assert from 'node:assert/strict';
import {
  SuspenseList,
  isSuspenseList,
  typeOf,
  isValidElementType,
  Element,
  createElement,
  createSuspenseListElement,
  checkIsSuspenseList,
  checkIsValidElementType,
  inspectTypeOf,
} from '../src/index.js';
import reactIs from 'react-is';

// Contract 1: react-is exports SuspenseList matching Symbol.for('react.suspense_list')
assert.equal(typeof SuspenseList, 'symbol', 'SuspenseList must be a symbol');
assert.equal(SuspenseList, Symbol.for('react.suspense_list'), 'SuspenseList must match Symbol.for("react.suspense_list")');
assert.equal(reactIs.SuspenseList, SuspenseList, 'Default import SuspenseList must match named import SuspenseList');
assert.equal(typeof isSuspenseList, 'function', 'isSuspenseList must be a function');
assert.equal(typeof typeOf, 'function', 'typeOf must be a function');
assert.equal(typeof isValidElementType, 'function', 'isValidElementType must be a function');

// Contract 2: isValidElementType identifies SuspenseList as a valid React element type
assert.equal(checkIsValidElementType(SuspenseList), true, 'SuspenseList must be recognized as a valid element type');
assert.equal(reactIs.isValidElementType(SuspenseList), true, 'react-is.isValidElementType must return true for SuspenseList');
assert.equal(checkIsValidElementType('div'), true, 'String tag must be a valid element type');
assert.equal(checkIsValidElementType(() => null), true, 'Function component must be a valid element type');
assert.equal(checkIsValidElementType(123), false, 'Number must not be a valid element type');
assert.equal(checkIsValidElementType(null), false, 'null must not be a valid element type');
assert.equal(checkIsValidElementType(undefined), false, 'undefined must not be a valid element type');

// Contract 3: isSuspenseList detects valid React 19 SuspenseList transitional elements
const suspenseListWithChildren = createSuspenseListElement({ revealOrder: 'forwards', children: [] });
assert.equal(checkIsSuspenseList(suspenseListWithChildren), true, 'SuspenseList element with children must be detected by checkIsSuspenseList');
assert.equal(isSuspenseList(suspenseListWithChildren), true, 'SuspenseList element with children must be detected by isSuspenseList');
assert.equal(reactIs.isSuspenseList(suspenseListWithChildren), true, 'SuspenseList element with children must be detected by reactIs.isSuspenseList');

const emptySuspenseList = createSuspenseListElement();
assert.equal(checkIsSuspenseList(emptySuspenseList), true, 'Empty SuspenseList element must be detected by checkIsSuspenseList');
assert.equal(isSuspenseList(emptySuspenseList), true, 'Empty SuspenseList element must be detected by isSuspenseList');
assert.equal(reactIs.isSuspenseList(emptySuspenseList), true, 'Empty SuspenseList element must be detected by reactIs.isSuspenseList');

// Contract 4: isSuspenseList returns false for SuspenseList symbol itself, legacy elements, non-suspense-list elements, and primitives
assert.equal(checkIsSuspenseList(SuspenseList), false, 'SuspenseList symbol itself is not an element instance');
assert.equal(isSuspenseList(SuspenseList), false, 'SuspenseList symbol itself must return false from isSuspenseList');
assert.equal(reactIs.isSuspenseList(SuspenseList), false, 'SuspenseList symbol itself must return false from reactIs.isSuspenseList');

const divElement = createElement('div', { id: 'root' });
assert.equal(checkIsSuspenseList(divElement), false, 'Plain div element must not be identified as a SuspenseList');
assert.equal(reactIs.isSuspenseList(divElement), false, 'Plain div element must return false from isSuspenseList');

const suspenseElement = createElement(Symbol.for('react.suspense'));
assert.equal(checkIsSuspenseList(suspenseElement), false, 'Suspense element must not be identified as a SuspenseList');

const legacySuspenseList = {
  $$typeof: Symbol.for('react.element'),
  type: SuspenseList,
  props: {},
  key: null,
  ref: null,
};
assert.equal(checkIsSuspenseList(legacySuspenseList), false, 'Legacy React element $$typeof is not recognized by React 19 react-is');

assert.equal(checkIsSuspenseList(null), false, 'null must return false');
assert.equal(checkIsSuspenseList(undefined), false, 'undefined must return false');
assert.equal(checkIsSuspenseList({}), false, 'Plain object must return false');
assert.equal(checkIsSuspenseList('react.suspense_list'), false, 'String must return false');
assert.equal(checkIsSuspenseList(42), false, 'Number must return false');
assert.equal(checkIsSuspenseList(true), false, 'Boolean must return false');
assert.equal(checkIsSuspenseList([]), false, 'Array must return false');

// Contract 5: typeOf returns SuspenseList symbol for valid suspense-list elements and undefined for non-elements or raw symbols
assert.equal(inspectTypeOf(suspenseListWithChildren), SuspenseList, 'inspectTypeOf must return SuspenseList symbol for suspense-list element');
assert.equal(typeOf(suspenseListWithChildren), SuspenseList, 'typeOf must return SuspenseList symbol for suspense-list element');
assert.equal(reactIs.typeOf(suspenseListWithChildren), SuspenseList, 'reactIs.typeOf must return SuspenseList symbol for suspense-list element');
assert.equal(inspectTypeOf(emptySuspenseList), SuspenseList, 'inspectTypeOf must return SuspenseList symbol for empty suspense-list element');

assert.equal(inspectTypeOf(divElement), Element, 'inspectTypeOf returns Element symbol for plain element');
assert.equal(inspectTypeOf(suspenseElement), Symbol.for('react.suspense'), 'inspectTypeOf returns Suspense symbol');
assert.equal(inspectTypeOf(SuspenseList), undefined, 'inspectTypeOf returns undefined for SuspenseList symbol');
assert.equal(inspectTypeOf(null), undefined, 'inspectTypeOf returns undefined for null');
assert.equal(inspectTypeOf(undefined), undefined, 'inspectTypeOf returns undefined for undefined');
assert.equal(inspectTypeOf({}), undefined, 'inspectTypeOf returns undefined for plain object');
assert.equal(inspectTypeOf(legacySuspenseList), undefined, 'inspectTypeOf returns undefined for legacy element');

console.log('All react-is.SuspenseList contract assertions passed.');