CodeSampleX

Sample

typescript 7.0.2: isClassDeclaration

Verified sample for npm typescript 7.0.2: isClassDeclaration. The contract ran on node 22 · linux alpine/x64 · docker and passed.

sha256:e93b9c07f1135ab63a43ce4c67569957ff524fdc44fa57f4a3235bf42a670442

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
1
Signing keys that built it
1
Declared environment node 22.23 linux 24 · ubuntu · glibc 2.39 x64 node 22.23 javascript npm 10

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5…		 2026-08-28

Case

HOW
Goal
verify typescript.isClassDeclaration in pkg:npm/typescript@7.0.2
Packages
Symbols
  • typescript.isClassDeclaration
Environment
node 22.23.2
Created
2026-08-28T07:49:28Z

Contract

  1. isClassDeclaration returns true for AST nodes constructed with createClassDeclaration
  2. isClassDeclaration distinguishes ClassDeclaration nodes from other AST nodes including ClassExpression and FunctionDeclaration
  3. safeIsClassDeclaration safely identifies ClassDeclaration AST nodes without throwing on null, undefined, or non-node values
  4. describeClassDeclaration inspects a ClassDeclaration node to extract metadata and throws TypeError on non-ClassDeclaration nodes

Files

  • PROMPT.md
  • csx.json
  • package-lock.json
  • package.json
  • spec.json
  • src/index.mjs
  • test/contract.mjs

Download the source artifact (tar.gz)

Source

PROMPT.md
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 typescript.isClassDeclaration in pkg:npm/typescript@7.0.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/typescript@7.0.2
Demonstrate these symbols/APIs:
  - typescript.isClassDeclaration

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.
csx.json
{"case":{"caseId":"case:sha256:9849d82b6b83dd807347280bace46da2a47c5cbafc42d37193be3b8c3677a2c8","contract":["isClassDeclaration returns true for AST nodes constructed with createClassDeclaration","isClassDeclaration distinguishes ClassDeclaration nodes from other AST nodes including ClassExpression and FunctionDeclaration","safeIsClassDeclaration safely identifies ClassDeclaration AST nodes without throwing on null, undefined, or non-node values","describeClassDeclaration inspects a ClassDeclaration node to extract metadata and throws TypeError on non-ClassDeclaration nodes"],"goal":"verify typescript.isClassDeclaration in pkg:npm/typescript@7.0.2","kind":"HOW","packages":["pkg:npm/typescript@7.0.2"],"schemaVersion":1,"symbols":["typescript.isClassDeclaration"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/typescript@7.0.2"],"schemaVersion":1,"subject":"pkg:npm/typescript@7.0.2","symbols":["typescript.isClassDeclaration"],"verifierAdapter":"node-typescript@1"}
package-lock.json
{
  "name": "typescript-is-class-declaration-sample",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "typescript-is-class-declaration-sample",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "typescript": "7.0.2"
      }
    },
    "node_modules/@typescript/typescript-aix-ppc64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-aix-ppc64/-/typescript-aix-ppc64-7.0.2.tgz",
      "integrity": "sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ==",
      "cpu": [
        "ppc64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "aix"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-darwin-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-arm64/-/typescript-darwin-arm64-7.0.2.tgz",
      "integrity": "sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "darwin"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-darwin-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-darwin-x64/-/typescript-darwin-x64-7.0.2.tgz",
      "integrity": "sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "darwin"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-freebsd-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-arm64/-/typescript-freebsd-arm64-7.0.2.tgz",
      "integrity": "sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "freebsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-freebsd-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-freebsd-x64/-/typescript-freebsd-x64-7.0.2.tgz",
      "integrity": "sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "freebsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-arm": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm/-/typescript-linux-arm-7.0.2.tgz",
      "integrity": "sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ==",
      "cpu": [
        "arm"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-arm64/-/typescript-linux-arm64-7.0.2.tgz",
      "integrity": "sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-loong64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-loong64/-/typescript-linux-loong64-7.0.2.tgz",
      "integrity": "sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ==",
      "cpu": [
        "loong64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-mips64el": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-mips64el/-/typescript-linux-mips64el-7.0.2.tgz",
      "integrity": "sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA==",
      "cpu": [
        "mips64el"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-ppc64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-ppc64/-/typescript-linux-ppc64-7.0.2.tgz",
      "integrity": "sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA==",
      "cpu": [
        "ppc64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-riscv64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-riscv64/-/typescript-linux-riscv64-7.0.2.tgz",
      "integrity": "sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ==",
      "cpu": [
        "riscv64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-s390x": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-s390x/-/typescript-linux-s390x-7.0.2.tgz",
      "integrity": "sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw==",
      "cpu": [
        "s390x"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-linux-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-linux-x64/-/typescript-linux-x64-7.0.2.tgz",
      "integrity": "sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "linux"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-netbsd-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-arm64/-/typescript-netbsd-arm64-7.0.2.tgz",
      "integrity": "sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "netbsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-netbsd-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-netbsd-x64/-/typescript-netbsd-x64-7.0.2.tgz",
      "integrity": "sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "netbsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-openbsd-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-arm64/-/typescript-openbsd-arm64-7.0.2.tgz",
      "integrity": "sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "openbsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-openbsd-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-openbsd-x64/-/typescript-openbsd-x64-7.0.2.tgz",
      "integrity": "sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "openbsd"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-sunos-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-sunos-x64/-/typescript-sunos-x64-7.0.2.tgz",
      "integrity": "sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "sunos"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-win32-arm64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-arm64/-/typescript-win32-arm64-7.0.2.tgz",
      "integrity": "sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ==",
      "cpu": [
        "arm64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "win32"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/@typescript/typescript-win32-x64": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/@typescript/typescript-win32-x64/-/typescript-win32-x64-7.0.2.tgz",
      "integrity": "sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g==",
      "cpu": [
        "x64"
      ],
      "license": "Apache-2.0",
      "optional": true,
      "os": [
        "win32"
      ],
      "engines": {
        "node": ">=16.20.0"
      }
    },
    "node_modules/typescript": {
      "version": "7.0.2",
      "resolved": "https://registry.npmjs.org/typescript/-/typescript-7.0.2.tgz",
      "integrity": "sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA==",
      "license": "Apache-2.0",
      "bin": {
        "tsc": "bin/tsc"
      },
      "engines": {
        "node": ">=16.20.0"
      },
      "optionalDependencies": {
        "@typescript/typescript-aix-ppc64": "7.0.2",
        "@typescript/typescript-darwin-arm64": "7.0.2",
        "@typescript/typescript-darwin-x64": "7.0.2",
        "@typescript/typescript-freebsd-arm64": "7.0.2",
        "@typescript/typescript-freebsd-x64": "7.0.2",
        "@typescript/typescript-linux-arm": "7.0.2",
        "@typescript/typescript-linux-arm64": "7.0.2",
        "@typescript/typescript-linux-loong64": "7.0.2",
        "@typescript/typescript-linux-mips64el": "7.0.2",
        "@typescript/typescript-linux-ppc64": "7.0.2",
        "@typescript/typescript-linux-riscv64": "7.0.2",
        "@typescript/typescript-linux-s390x": "7.0.2",
        "@typescript/typescript-linux-x64": "7.0.2",
        "@typescript/typescript-netbsd-arm64": "7.0.2",
        "@typescript/typescript-netbsd-x64": "7.0.2",
        "@typescript/typescript-openbsd-arm64": "7.0.2",
        "@typescript/typescript-openbsd-x64": "7.0.2",
        "@typescript/typescript-sunos-x64": "7.0.2",
        "@typescript/typescript-win32-arm64": "7.0.2",
        "@typescript/typescript-win32-x64": "7.0.2"
      }
    }
  }
}
package.json
{
  "name": "typescript-is-class-declaration-sample",
  "version": "1.0.0",
  "description": "verify typescript.isClassDeclaration in pkg:npm/typescript@7.0.2",
  "type": "module",
  "main": "src/index.mjs",
  "license": "MIT-0",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "typescript": "7.0.2"
  }
}
spec.json
{
  "schemaVersion": 1,
  "goal": "verify typescript.isClassDeclaration in pkg:npm/typescript@7.0.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/typescript@7.0.2"
  ],
  "symbols": [
    "typescript.isClassDeclaration"
  ]
}
src/index.mjs
import {
  isClassDeclaration as tsIsClassDeclaration,
  SyntaxKind,
  formatSyntaxKind,
} from 'typescript/unstable/ast';
import {
  createClassDeclaration,
  createIdentifier,
  createToken,
} from 'typescript/unstable/ast/factory';

/**
 * Safely determines whether a given value is a TypeScript ClassDeclaration AST node.
 * Unlike the raw tsIsClassDeclaration, this function does not throw on null, undefined, or primitives.
 *
 * @param {unknown} node
 * @returns {boolean}
 */
export function safeIsClassDeclaration(node) {
  if (!node || typeof node !== 'object' || typeof node.kind !== 'number') {
    return false;
  }
  return tsIsClassDeclaration(node);
}

/**
 * Builds a ClassDeclaration AST node with optional name and members.
 *
 * @param {string | import('typescript/unstable/ast').Identifier} [name]
 * @param {object} [options]
 * @param {Array} [options.modifiers]
 * @param {Array} [options.typeParameters]
 * @param {Array} [options.heritageClauses]
 * @param {Array} [options.members]
 * @returns {import('typescript/unstable/ast').ClassDeclaration}
 */
export function buildClassDeclaration(name, options = {}) {
  const nameNode = typeof name === 'string' ? createIdentifier(name) : name;
  const {
    modifiers = undefined,
    typeParameters = undefined,
    heritageClauses = undefined,
    members = [],
  } = options;

  return createClassDeclaration(
    modifiers,
    nameNode,
    typeParameters,
    heritageClauses,
    members
  );
}

/**
 * Inspects a ClassDeclaration node and extracts structural information.
 *
 * @param {unknown} node
 * @returns {{ kind: number, kindName: string, name: string | null, memberCount: number, isAnonymous: boolean }}
 * @throws {TypeError} if node is not a ClassDeclaration
 */
export function describeClassDeclaration(node) {
  if (!safeIsClassDeclaration(node)) {
    throw new TypeError('Expected a TypeScript ClassDeclaration AST node');
  }

  const name = node.name?._data?.text ?? (node.name?.text || null);
  const memberCount = Array.isArray(node.members) ? node.members.length : 0;

  return {
    kind: node.kind,
    kindName: formatSyntaxKind(node.kind),
    name,
    memberCount,
    isAnonymous: name === null,
  };
}

export {
  tsIsClassDeclaration as isClassDeclaration,
  SyntaxKind,
  formatSyntaxKind,
  createClassDeclaration,
  createIdentifier,
  createToken,
};
test/contract.mjs
import assert from 'node:assert/strict';
import {
  isClassDeclaration,
  safeIsClassDeclaration,
  buildClassDeclaration,
  describeClassDeclaration,
  createClassDeclaration,
  createIdentifier,
  createToken,
  SyntaxKind,
  formatSyntaxKind,
} from '../src/index.mjs';
import {
  createClassExpression,
  createFunctionDeclaration,
  createPropertyDeclaration,
} from 'typescript/unstable/ast/factory';

// Contract 1: isClassDeclaration returns true for AST nodes constructed with createClassDeclaration
{
  const className = createIdentifier('UserProfile');
  const classNode = createClassDeclaration(
    undefined, // modifiers
    className, // name
    undefined, // typeParameters
    undefined, // heritageClauses
    []         // members
  );

  assert.ok(classNode, 'Class declaration node should be created');
  assert.strictEqual(isClassDeclaration(classNode), true, 'isClassDeclaration should return true for ClassDeclaration node');
  assert.strictEqual(classNode.kind, SyntaxKind.ClassDeclaration, 'Node kind should be SyntaxKind.ClassDeclaration');
  assert.strictEqual(formatSyntaxKind(classNode.kind), 'ClassDeclaration', 'formatSyntaxKind should return ClassDeclaration');
  assert.strictEqual(classNode.name?.text, 'UserProfile', 'Class name should match');

  // Anonymous class declaration (e.g. default export class)
  const anonClass = createClassDeclaration(undefined, undefined, undefined, undefined, []);
  assert.ok(anonClass, 'Anonymous class declaration should be created');
  assert.strictEqual(isClassDeclaration(anonClass), true, 'isClassDeclaration should return true for anonymous ClassDeclaration');
  assert.strictEqual(anonClass.name, undefined, 'Anonymous class name should be undefined');

  // Helper buildClassDeclaration
  const builtClass = buildClassDeclaration('OrderManager');
  assert.strictEqual(isClassDeclaration(builtClass), true, 'buildClassDeclaration should produce a valid ClassDeclaration');
  assert.strictEqual(builtClass.name?.text, 'OrderManager');
}

// Contract 2: isClassDeclaration distinguishes ClassDeclaration nodes from other AST nodes including ClassExpression and FunctionDeclaration
{
  const exprName = createIdentifier('ExprClass');
  const classExpr = createClassExpression(undefined, exprName, undefined, undefined, []);
  assert.strictEqual(isClassDeclaration(classExpr), false, 'isClassDeclaration should return false for ClassExpression');

  const fn = createFunctionDeclaration(undefined, undefined, createIdentifier('myFunction'), undefined, [], undefined, undefined);
  assert.strictEqual(isClassDeclaration(fn), false, 'isClassDeclaration should return false for FunctionDeclaration');

  const prop = createPropertyDeclaration(undefined, createIdentifier('count'), undefined, undefined, undefined);
  assert.strictEqual(isClassDeclaration(prop), false, 'isClassDeclaration should return false for PropertyDeclaration');

  const ident = createIdentifier('myVariable');
  assert.strictEqual(isClassDeclaration(ident), false, 'isClassDeclaration should return false for Identifier');

  const token = createToken(SyntaxKind.ExportKeyword);
  assert.strictEqual(isClassDeclaration(token), false, 'isClassDeclaration should return false for Modifier token');
}

// Contract 3: safeIsClassDeclaration safely identifies ClassDeclaration AST nodes without throwing on null, undefined, or non-node values
{
  const validClass = buildClassDeclaration('Service');
  assert.strictEqual(safeIsClassDeclaration(validClass), true, 'safeIsClassDeclaration should return true for valid class');

  assert.strictEqual(safeIsClassDeclaration(null), false, 'null should return false');
  assert.strictEqual(safeIsClassDeclaration(undefined), false, 'undefined should return false');
  assert.strictEqual(safeIsClassDeclaration(42), false, 'number primitive should return false');
  assert.strictEqual(safeIsClassDeclaration('class Foo {}'), false, 'string primitive should return false');
  assert.strictEqual(safeIsClassDeclaration({}), false, 'empty object should return false');
  assert.strictEqual(safeIsClassDeclaration({ kind: SyntaxKind.Identifier }), false, 'non-class AST-like object should return false');
  assert.strictEqual(safeIsClassDeclaration({ kind: SyntaxKind.ClassDeclaration }), true, 'class-declaration AST-like object should return true');
}

// Contract 4: describeClassDeclaration inspects a ClassDeclaration node to extract metadata and throws TypeError on non-ClassDeclaration nodes
{
  const prop = createPropertyDeclaration(undefined, createIdentifier('status'), undefined, undefined, undefined);
  const classWithMember = buildClassDeclaration('Account', { members: [prop] });

  const desc = describeClassDeclaration(classWithMember);
  assert.strictEqual(desc.kind, SyntaxKind.ClassDeclaration);
  assert.strictEqual(desc.kindName, 'ClassDeclaration');
  assert.strictEqual(desc.name, 'Account');
  assert.strictEqual(desc.memberCount, 1);
  assert.strictEqual(desc.isAnonymous, false);

  const anonDesc = describeClassDeclaration(buildClassDeclaration(undefined));
  assert.strictEqual(anonDesc.name, null);
  assert.strictEqual(anonDesc.isAnonymous, true);
  assert.strictEqual(anonDesc.memberCount, 0);

  assert.throws(() => describeClassDeclaration(null), { name: 'TypeError' }, 'Should throw TypeError on null');
  assert.throws(() => describeClassDeclaration(createIdentifier('notAClass')), { name: 'TypeError' }, 'Should throw TypeError on non-class node');
}

console.log('All pkg:npm/typescript@7.0.2 contracts passed successfully.');

Origin Seeder

anonymous