eslint-plugin-react-hooks 5.2.0: meta

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 eslint-plugin-react-hooks.meta in pkg:npm/eslint-plugin-react-hooks@5.2.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/eslint-plugin-react-hooks@5.2.0
Demonstrate these symbols/APIs:
  - eslint-plugin-react-hooks.meta

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:774c5c74c03bd6eddc61dfd6897509d2abfb488575420ce7ec9535590db98c1d","contract":["eslint-plugin-react-hooks exports named meta object and default export includes matching meta","meta defines name property identifying eslint-plugin-react-hooks","meta conforms to ESLint plugin metadata object structure with string name property","configs.recommended-latest flat configuration plugin definition references plugin meta object"],"goal":"verify eslint-plugin-react-hooks.meta in pkg:npm/eslint-plugin-react-hooks@5.2.0","kind":"HOW","packages":["pkg:npm/eslint-plugin-react-hooks@5.2.0"],"schemaVersion":1,"symbols":["eslint-plugin-react-hooks.meta"]},"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/eslint-plugin-react-hooks@5.2.0"],"schemaVersion":1,"subject":"pkg:npm/eslint-plugin-react-hooks@5.2.0","symbols":["eslint-plugin-react-hooks.meta"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-eslint-plugin-react-hooks-meta",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-eslint-plugin-react-hooks-meta",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "eslint-plugin-react-hooks": "5.2.0"
      }
    },
    "node_modules/eslint-plugin-react-hooks": {
      "version": "5.2.0",
      "resolved": "https://registry.npmjs.org/eslint-plugin-react-hooks/-/eslint-plugin-react-hooks-5.2.0.tgz",
      "integrity": "sha512-+f15FfK64YQwZdJNELETdn5ibXEUQmW1DZL6KXhNnc2heoy/sg9VJJeT7n8TlMWouzWqSWavFkIhHyIbIAEapg==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      }
    }
  }
}

{
  "name": "sample-eslint-plugin-react-hooks-meta",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification of eslint-plugin-react-hooks meta export",
  "type": "module",
  "main": "src/index.js",
  "license": "MIT-0",
  "dependencies": {
    "eslint-plugin-react-hooks": "5.2.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify eslint-plugin-react-hooks.meta in pkg:npm/eslint-plugin-react-hooks@5.2.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/eslint-plugin-react-hooks@5.2.0"
  ],
  "symbols": [
    "eslint-plugin-react-hooks.meta"
  ]
}

import { meta, default as plugin, configs } from 'eslint-plugin-react-hooks';

/**
 * Retrieve the plugin metadata object from eslint-plugin-react-hooks.
 *
 * @returns {object} Plugin meta object containing name
 */
export function getPluginMeta() {
  return meta;
}

/**
 * Retrieve the plugin name from the meta object.
 *
 * @returns {string} Package name declared in plugin meta
 */
export function getPluginName() {
  return meta.name;
}

/**
 * Check if the plugin meta object satisfies ESLint plugin metadata requirements.
 *
 * @param {object} [customMeta] - Optional meta object to validate, defaults to plugin meta
 * @returns {boolean} True if meta defines a non-empty string name
 */
export function isValidPluginMeta(customMeta = meta) {
  return Boolean(
    customMeta &&
    typeof customMeta === 'object' &&
    typeof customMeta.name === 'string' &&
    customMeta.name.length > 0
  );
}

/**
 * Retrieve the plugin meta object referenced inside recommended-latest flat config.
 *
 * @returns {object|undefined} Plugin meta from flat config plugin definition
 */
export function getFlatConfigPluginMeta() {
  const latest = configs['recommended-latest'];
  return latest?.plugins?.['react-hooks']?.meta;
}

export { meta, plugin, configs };

import assert from 'node:assert/strict';
import reactHooksPlugin, { meta } from 'eslint-plugin-react-hooks';
import {
  getPluginMeta,
  getPluginName,
  isValidPluginMeta,
  getFlatConfigPluginMeta,
} from '../src/index.js';

// 1. eslint-plugin-react-hooks exports named meta object and default export includes matching meta
assert.ok(meta, 'named meta export must be defined');
assert.equal(typeof meta, 'object', 'meta export must be an object');
assert.notEqual(meta, null, 'meta export must not be null');
assert.ok(reactHooksPlugin.meta, 'default export meta must be defined');
assert.equal(reactHooksPlugin.meta, meta, 'default export meta must strictly equal named meta export');
assert.equal(getPluginMeta(), meta, 'getPluginMeta helper must return meta export');

// 2. meta defines name property identifying eslint-plugin-react-hooks
assert.equal(meta.name, 'eslint-plugin-react-hooks', 'meta.name must match package name');
assert.equal(getPluginName(), 'eslint-plugin-react-hooks', 'getPluginName helper must return package name');

// 3. meta conforms to ESLint plugin metadata object structure with string name property
assert.equal(isValidPluginMeta(), true, 'plugin meta must be valid per ESLint metadata requirements');
assert.equal(isValidPluginMeta(meta), true, 'meta object must validate as valid plugin meta');
assert.equal(isValidPluginMeta(null), false, 'null must not validate as valid plugin meta');
assert.equal(isValidPluginMeta({}), false, 'empty object must not validate as valid plugin meta');
assert.equal(isValidPluginMeta({ name: '' }), false, 'empty name string must not validate as valid plugin meta');
assert.equal(Object.prototype.hasOwnProperty.call(meta, 'name'), true, 'meta must possess own property "name"');

// 4. configs.recommended-latest flat configuration plugin definition references plugin meta object
const flatMeta = getFlatConfigPluginMeta();
assert.ok(flatMeta, 'flat config plugin meta must be defined');
assert.equal(flatMeta, meta, 'flat config plugin meta must reference the same meta object');
assert.equal(flatMeta.name, 'eslint-plugin-react-hooks', 'flat config plugin meta name must match package name');

console.log('Contract assertions passed successfully.');