示例

typescript 7.0.2: createTypeParameterDeclaration

已验证示例 — npm typescript 7.0.2: createTypeParameterDeclaration. contract 在 node 22 · linux alpine/x64 · docker 上运行并通过： typescript/unstable/ast/factory exports…

sha256:e9924d2c9c2fd7bfe74953c390514eb52680c4ec847103188f2f3408a8b7c858

MIT-0

执行证据

声明的环境与签名的运行分开呈现，你可以看到这个样本究竟运行了什么、在哪里运行。

证据依据: 签名契约通过
验证回执: 1
构建过它的签名密钥: 1

声明的环境 node 22.23 linux 24 · ubuntu · glibc 2.39 x64 node 22.23 javascript npm 10

验证运行环境

环境	契约	阶段	运行日期
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

案例

HOW

目标: verify typescript.createTypeParameterDeclaration in pkg:npm/typescript@7.0.2
包: typescript 7.0.2
符号: typescript.createTypeParameterDeclaration
环境: node 22.23.2
创建时间: 2026-08-28T07:40:37Z

契约

typescript/unstable/ast/factory exports createTypeParameterDeclaration and updateTypeParameterDeclaration
createTypeParameterDeclaration constructs a basic TypeParameterDeclaration AST node
createTypeParameterDeclaration constructs constrained type parameters with extends clause and default types
createTypeParameterDeclaration supports variance and const modifiers
updateTypeParameterDeclaration preserves identity when unchanged and creates updated node when changed
inspectTypeParameterDeclaration extracts structural metadata and rejects invalid inputs

文件

PROMPT.md
csx.json
index.js
package-lock.json
package.json
spec.json
test/contract.js

下载源代码构件 (tar.gz)

源代码

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.createTypeParameterDeclaration 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.createTypeParameterDeclaration

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:0c202ec1cc42e1394093e5cc575e50bf1baa0150b53da858a8a75480aa38885c","contract":["typescript/unstable/ast/factory exports createTypeParameterDeclaration and updateTypeParameterDeclaration","createTypeParameterDeclaration constructs a basic TypeParameterDeclaration AST node","createTypeParameterDeclaration constructs constrained type parameters with extends clause and default types","createTypeParameterDeclaration supports variance and const modifiers","updateTypeParameterDeclaration preserves identity when unchanged and creates updated node when changed","inspectTypeParameterDeclaration extracts structural metadata and rejects invalid inputs"],"goal":"verify typescript.createTypeParameterDeclaration in pkg:npm/typescript@7.0.2","kind":"HOW","packages":["pkg:npm/typescript@7.0.2"],"schemaVersion":1,"symbols":["typescript.createTypeParameterDeclaration"]},"contractCommand":["node","test/contract.js"],"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/typescript@7.0.2"],"schemaVersion":1,"subject":"pkg:npm/typescript@7.0.2","symbols":["typescript.createTypeParameterDeclaration"],"verifierAdapter":"node-typescript@1"}

index.js

const {
  createTypeParameterDeclaration,
  updateTypeParameterDeclaration,
  createIdentifier,
  createToken,
  createTypeReferenceNode
} = require('typescript/unstable/ast/factory');

const {
  SyntaxKind,
  isTypeParameterDeclaration,
  isIdentifier,
  isTypeReferenceNode,
  isToken,
  formatSyntaxKind
} = require('typescript/unstable/ast');

/**
 * Builds a basic TypeParameterDeclaration AST node.
 *
 * @param {string | object} name - Identifier name or node.
 * @param {object} [options={}] - Optional configuration.
 * @param {object} [options.constraint] - Constraint TypeNode (e.g. extends T).
 * @param {object} [options.defaultType] - Default TypeNode (e.g. = T).
 * @param {Array<object>} [options.modifiers] - Modifier tokens (e.g. const, in, out).
 * @returns {object} TypeParameterDeclaration AST node.
 */
function buildTypeParameter(name, options = {}) {
  const nameNode = typeof name === 'string' ? createIdentifier(name) : name;
  const constraintNode = typeof options.constraint === 'string'
    ? createTypeReferenceNode(createIdentifier(options.constraint), undefined)
    : options.constraint;
  const defaultNode = typeof options.defaultType === 'string'
    ? createTypeReferenceNode(createIdentifier(options.defaultType), undefined)
    : options.defaultType;
  const modifiers = Array.isArray(options.modifiers) && options.modifiers.length > 0
    ? options.modifiers
    : undefined;

  return createTypeParameterDeclaration(
    modifiers,
    nameNode,
    constraintNode,
    undefined,
    defaultNode
  );
}

/**
 * Builds a constrained TypeParameterDeclaration AST node with extends constraint and default type.
 *
 * @param {string | object} name - Type parameter name.
 * @param {string | object} constraint - Type name or node for extends constraint.
 * @param {string | object} [defaultType] - Type name or node for default type.
 * @returns {object} TypeParameterDeclaration AST node.
 */
function buildConstrainedTypeParameter(name, constraint, defaultType) {
  return buildTypeParameter(name, { constraint, defaultType });
}

/**
 * Inspects a TypeParameterDeclaration node and extracts structural metadata.
 *
 * @param {object} node - AST node to inspect.
 * @returns {{
 *   kind: number,
 *   kindName: string,
 *   isTypeParameterDeclaration: boolean,
 *   name: string,
 *   hasConstraint: boolean,
 *   hasDefaultType: boolean,
 *   modifierKinds: Array<number>
 * }}
 */
function inspectTypeParameterDeclaration(node) {
  if (!node || typeof node !== 'object') {
    throw new TypeError('Expected an AST node object');
  }

  const isTypeParam = isTypeParameterDeclaration(node);
  if (!isTypeParam) {
    return {
      kind: node.kind,
      kindName: formatSyntaxKind ? formatSyntaxKind(node.kind) : String(node.kind),
      isTypeParameterDeclaration: false,
      name: '',
      hasConstraint: false,
      hasDefaultType: false,
      modifierKinds: []
    };
  }

  const rawName = node.name ? (node.name.text ?? node.name._data?.text ?? '') : '';
  const modifierKinds = Array.isArray(node.modifiers) ? node.modifiers.map(m => m.kind) : [];

  return {
    kind: node.kind,
    kindName: formatSyntaxKind ? formatSyntaxKind(node.kind) : 'TypeParameter',
    isTypeParameterDeclaration: true,
    name: rawName,
    hasConstraint: node.constraint !== undefined,
    hasDefaultType: node.defaultType !== undefined,
    modifierKinds
  };
}

module.exports = {
  buildTypeParameter,
  buildConstrainedTypeParameter,
  inspectTypeParameterDeclaration,
  createTypeParameterDeclaration,
  updateTypeParameterDeclaration,
  createIdentifier,
  createToken,
  createTypeReferenceNode,
  SyntaxKind,
  isTypeParameterDeclaration,
  isIdentifier,
  isTypeReferenceNode,
  isToken,
  formatSyntaxKind
};

package-lock.json

{
  "name": "sample-typescript-create-type-parameter-declaration",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-typescript-create-type-parameter-declaration",
      "version": "1.0.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": "sample-typescript-create-type-parameter-declaration",
  "version": "1.0.0",
  "private": true,
  "description": "verify typescript.createTypeParameterDeclaration in pkg:npm/typescript@7.0.2",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "typescript": "7.0.2"
  }
}

spec.json

{
  "schemaVersion": 1,
  "goal": "verify typescript.createTypeParameterDeclaration in pkg:npm/typescript@7.0.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/typescript@7.0.2"
  ],
  "symbols": [
    "typescript.createTypeParameterDeclaration"
  ]
}

test/contract.js

const assert = require('node:assert/strict');
const {
  buildTypeParameter,
  buildConstrainedTypeParameter,
  inspectTypeParameterDeclaration,
  createTypeParameterDeclaration,
  updateTypeParameterDeclaration,
  createIdentifier,
  createToken,
  createTypeReferenceNode,
  SyntaxKind,
  isTypeParameterDeclaration,
  isIdentifier,
  isTypeReferenceNode,
  formatSyntaxKind
} = require('../index.js');

// Contract 1: typescript/unstable/ast/factory exports createTypeParameterDeclaration and updateTypeParameterDeclaration
{
  assert.strictEqual(typeof createTypeParameterDeclaration, 'function');
  assert.strictEqual(typeof updateTypeParameterDeclaration, 'function');
  assert.strictEqual(typeof isTypeParameterDeclaration, 'function');
}

// Contract 2: createTypeParameterDeclaration constructs a basic TypeParameterDeclaration AST node
{
  const idT = createIdentifier('T');
  const tp = createTypeParameterDeclaration(undefined, idT);

  assert.ok(tp, 'TypeParameter node should be created');
  assert.strictEqual(isTypeParameterDeclaration(tp), true, 'isTypeParameterDeclaration should return true');
  assert.strictEqual(tp.kind, SyntaxKind.TypeParameter, 'Node kind should be SyntaxKind.TypeParameter');
  assert.strictEqual(formatSyntaxKind(tp.kind), 'TypeParameter', 'formatSyntaxKind should return TypeParameter');
  assert.strictEqual(tp.name.text, 'T', 'Name text should be T');
  assert.strictEqual(tp.constraint, undefined, 'Constraint should be undefined');
  assert.strictEqual(tp.defaultType, undefined, 'DefaultType should be undefined');
}

// Contract 3: createTypeParameterDeclaration constructs constrained type parameters with extends clause and default types
{
  const constraintNode = createTypeReferenceNode(createIdentifier('Comparable'), undefined);
  const defaultNode = createTypeReferenceNode(createIdentifier('string'), undefined);
  const tp = createTypeParameterDeclaration(
    undefined,
    createIdentifier('Item'),
    constraintNode,
    undefined,
    defaultNode
  );

  assert.strictEqual(isTypeParameterDeclaration(tp), true);
  assert.strictEqual(tp.name.text, 'Item');
  assert.strictEqual(isTypeReferenceNode(tp.constraint), true);
  assert.strictEqual(tp.constraint.typeName.text, 'Comparable');
  assert.strictEqual(isTypeReferenceNode(tp.defaultType), true);
  assert.strictEqual(tp.defaultType.typeName.text, 'string');
}

// Contract 4: createTypeParameterDeclaration supports variance and const modifiers
{
  const inModifier = createToken(SyntaxKind.InKeyword);
  const constModifier = createToken(SyntaxKind.ConstKeyword);
  const tp = createTypeParameterDeclaration(
    [constModifier, inModifier],
    createIdentifier('Input')
  );

  assert.strictEqual(isTypeParameterDeclaration(tp), true);
  assert.ok(Array.isArray(tp.modifiers));
  assert.strictEqual(tp.modifiers.length, 2);
  assert.strictEqual(tp.modifiers[0].kind, SyntaxKind.ConstKeyword);
  assert.strictEqual(tp.modifiers[1].kind, SyntaxKind.InKeyword);
}

// Contract 5: updateTypeParameterDeclaration preserves identity when unchanged and creates updated node when changed
{
  const idK = createIdentifier('K');
  const original = createTypeParameterDeclaration(undefined, idK);
  const identical = updateTypeParameterDeclaration(original, undefined, idK, undefined, undefined, undefined);
  assert.strictEqual(identical, original, 'update with identical properties should return original instance');

  const newName = createIdentifier('V');
  const updated = updateTypeParameterDeclaration(original, undefined, newName, undefined, undefined, undefined);
  assert.notStrictEqual(updated, original, 'update with changed properties should return new instance');
  assert.strictEqual(updated.name.text, 'V');
  assert.strictEqual(isTypeParameterDeclaration(updated), true);
}

// Contract 6: inspectTypeParameterDeclaration extracts structural metadata and rejects invalid inputs
{
  const tp = buildConstrainedTypeParameter('Entity', 'BaseEntity', 'DefaultEntity');
  const info = inspectTypeParameterDeclaration(tp);

  assert.strictEqual(info.isTypeParameterDeclaration, true);
  assert.strictEqual(info.kindName, 'TypeParameter');
  assert.strictEqual(info.name, 'Entity');
  assert.strictEqual(info.hasConstraint, true);
  assert.strictEqual(info.hasDefaultType, true);
  assert.deepStrictEqual(info.modifierKinds, []);

  assert.throws(
    () => inspectTypeParameterDeclaration(null),
    { name: 'TypeError' },
    'inspectTypeParameterDeclaration should throw TypeError on non-object'
  );
}

console.log('All typescript.createTypeParameterDeclaration contracts passed successfully.');

原始种子者

匿名