react-is 17.0.2: ContextProvider

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

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

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:90ad24c16783ee9efc4cf556aa5378a1908c1e6aa3ef4a210f7a28db47c3102f","contract":["ContextProvider is exported as the React provider type symbol","typeOf identifies elements with ContextProvider $$typeof as ContextProvider","isContextProvider returns true for elements created with ContextProvider type","non-provider elements and plain objects are rejected by isContextProvider and do not match ContextProvider"],"goal":"verify react-is.ContextProvider in pkg:npm/react-is@17.0.2","kind":"HOW","packages":["pkg:npm/react-is@17.0.2"],"schemaVersion":1,"symbols":["react-is.ContextProvider"]},"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@17.0.2"],"schemaVersion":1,"subject":"pkg:npm/react-is@17.0.2","symbols":["react-is.ContextProvider"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-react-is-context-provider",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-react-is-context-provider",
      "version": "1.0.0",
      "dependencies": {
        "react-is": "17.0.2"
      }
    },
    "node_modules/react-is": {
      "version": "17.0.2",
      "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",
      "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==",
      "license": "MIT"
    }
  }
}

{
  "name": "sample-react-is-context-provider",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification of react-is 17.0.2 ContextProvider symbol identification",
  "type": "module",
  "main": "src/index.js",
  "dependencies": {
    "react-is": "17.0.2"
  }
}

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

import { ContextProvider, isContextProvider, typeOf } from 'react-is';

/**
 * Get the exported ContextProvider symbol identifier.
 *
 * @returns {symbol|number} The ContextProvider type symbol.
 */
export function getContextProviderSymbol() {
  return ContextProvider;
}

/**
 * Check if the given value is a React Context Provider element.
 *
 * @param {*} value - The value to check.
 * @returns {boolean} True if the value is a Context Provider element.
 */
export function checkIsContextProvider(value) {
  return isContextProvider(value);
}

/**
 * Identify the React element type symbol using typeOf.
 *
 * @param {*} value - The value to inspect.
 * @returns {symbol|number|undefined} The React element type or undefined.
 */
export function identifyTypeOf(value) {
  return typeOf(value);
}

export {
  ContextProvider,
  isContextProvider,
  typeOf,
};

import assert from 'node:assert/strict';
import {
  ContextProvider,
  isContextProvider,
  typeOf,
  getContextProviderSymbol,
  checkIsContextProvider,
  identifyTypeOf,
} from '../src/index.js';

// 1. ContextProvider constant and symbol verification
assert.equal(typeof ContextProvider, 'symbol', 'ContextProvider should be a symbol in modern environments');
assert.equal(ContextProvider, Symbol.for('react.provider'), 'ContextProvider must equal Symbol.for("react.provider")');
assert.equal(getContextProviderSymbol(), ContextProvider, 'getContextProviderSymbol helper must return ContextProvider');

// 2. Function exports verification
assert.equal(typeof isContextProvider, 'function', 'isContextProvider should be a function');
assert.equal(typeof typeOf, 'function', 'typeOf should be a function');
assert.equal(typeof checkIsContextProvider, 'function', 'checkIsContextProvider helper should be a function');
assert.equal(typeof identifyTypeOf, 'function', 'identifyTypeOf helper should be a function');

// 3. Identification of valid React Context Provider elements
const dummyContext = {};
const providerType = {
  $$typeof: ContextProvider,
  _context: dummyContext,
};

const providerElement = {
  $$typeof: Symbol.for('react.element'),
  type: providerType,
  props: { value: 'context-value' },
  key: null,
  ref: null,
};

assert.equal(isContextProvider(providerElement), true, 'isContextProvider must return true for Context.Provider element');
assert.equal(checkIsContextProvider(providerElement), true, 'checkIsContextProvider helper must return true');
assert.equal(typeOf(providerElement), ContextProvider, 'typeOf on Context.Provider element must equal ContextProvider');
assert.equal(identifyTypeOf(providerElement), ContextProvider, 'identifyTypeOf helper must return ContextProvider');

// 4. Rejection of non-provider elements and primitives
const plainElement = {
  $$typeof: Symbol.for('react.element'),
  type: 'div',
  props: {},
  key: null,
  ref: null,
};

const consumerElement = {
  $$typeof: Symbol.for('react.element'),
  type: {
    $$typeof: Symbol.for('react.context'),
    _context: dummyContext,
  },
  props: {},
  key: null,
  ref: null,
};

assert.equal(isContextProvider(plainElement), false, 'plain div element is not a ContextProvider');
assert.equal(checkIsContextProvider(plainElement), false, 'checkIsContextProvider helper returns false for plain element');
assert.notEqual(typeOf(plainElement), ContextProvider, 'typeOf(plainElement) must not equal ContextProvider');

assert.equal(isContextProvider(consumerElement), false, 'context consumer element is not a ContextProvider');
assert.notEqual(typeOf(consumerElement), ContextProvider, 'typeOf(consumerElement) must not equal ContextProvider');

assert.equal(isContextProvider(null), false, 'null is not a ContextProvider');
assert.equal(isContextProvider(undefined), false, 'undefined is not a ContextProvider');
assert.equal(isContextProvider({}), false, 'empty object is not a ContextProvider');
assert.equal(isContextProvider('string'), false, 'string is not a ContextProvider');
assert.equal(typeOf({}), undefined, 'typeOf on plain object must be undefined');

console.log('Contract passed: react-is.ContextProvider verified successfully.');