示例

typescript 7.0.2: createConstructorDeclaration

已验证示例 — npm typescript 7.0.2: createConstructorDeclaration. contract 在 node 22 · linux alpine/x64 · docker 上运行并通过： buildConstructorDeclaration constructs a…

sha256:1ee097888c504885010543f09b3191556f38dc28392ea2466d0eeec456828e13

MIT-0

执行证据

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

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

声明的环境 linux 24 · ubuntu · glibc 2.39 x64 npm

验证运行环境

环境	契约	阶段	运行日期
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.createConstructorDeclaration in pkg:npm/typescript@7.0.2
包: typescript 7.0.2
符号: typescript.createConstructorDeclaration
创建时间: 2026-08-28T07:11:01Z

契约

buildConstructorDeclaration constructs a constructor AST node with parameters and body statements using createConstructorDeclaration and validates it with isConstructorDeclaration
buildConstructorDeclaration constructs constructor declarations with access modifiers and parameter property modifiers (public, private, protected, readonly)
buildConstructorDeclaration supports overload signature declarations without body blocks using isSignature option
buildClassWithConstructor embeds constructor declarations inside a class AST node and validates constructor member hierarchy
inspectConstructorDeclaration extracts constructor metadata, parameter details, and modifier flags using AST type guards

文件

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

下载源代码构件 (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.createConstructorDeclaration 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.createConstructorDeclaration

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:53ee3e38ea580a8f11939092aabceabb498010d5c4d19d78a915e1174f091143","contract":["buildConstructorDeclaration constructs a constructor AST node with parameters and body statements using createConstructorDeclaration and validates it with isConstructorDeclaration","buildConstructorDeclaration constructs constructor declarations with access modifiers and parameter property modifiers (public, private, protected, readonly)","buildConstructorDeclaration supports overload signature declarations without body blocks using isSignature option","buildClassWithConstructor embeds constructor declarations inside a class AST node and validates constructor member hierarchy","inspectConstructorDeclaration extracts constructor metadata, parameter details, and modifier flags using AST type guards"],"goal":"verify typescript.createConstructorDeclaration in pkg:npm/typescript@7.0.2","kind":"HOW","packages":["pkg:npm/typescript@7.0.2"],"schemaVersion":1,"symbols":["typescript.createConstructorDeclaration"]},"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/typescript@7.0.2"],"schemaVersion":1,"subject":"pkg:npm/typescript@7.0.2","symbols":["typescript.createConstructorDeclaration"],"verifierAdapter":"node-typescript@1"}

package-lock.json

{
  "name": "typescript-constructor-declaration-sample",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "typescript-constructor-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-constructor-declaration-sample",
  "version": "1.0.0",
  "description": "Construct and validate TypeScript constructor declarations using createConstructorDeclaration",
  "type": "module",
  "main": "src/index.mjs",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "typescript": "7.0.2"
  },
  "license": "MIT-0"
}

spec.json

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

src/index.mjs

import {
  createConstructorDeclaration,
  createClassDeclaration,
  createParameterDeclaration,
  createBlock,
  createIdentifier,
  createToken,
  createKeywordExpression,
  createKeywordTypeNode,
  createTypeReferenceNode,
  createExpressionStatement,
  createBinaryExpression,
  createPropertyAccessExpression,
  createCallExpression,
  createReturnStatement,
  createStringLiteral,
  createNumericLiteral,
} from 'typescript/unstable/ast/factory';

import {
  SyntaxKind,
  formatSyntaxKind,
  isConstructorDeclaration,
  isClassDeclaration,
  isParameterDeclaration,
  isBlock,
  isIdentifier,
  isToken,
  isKeywordTypeNode,
  isTypeReferenceNode,
} from 'typescript/unstable/ast';

/**
 * Converts a string type name or TypeNode into a valid TypeNode.
 *
 * @param {string | object} [type] - Type name or AST TypeNode.
 * @returns {object | undefined} AST TypeNode.
 */
function toTypeNode(type) {
  if (!type) return undefined;
  if (typeof type === 'object') return type;
  switch (type) {
    case 'string':
      return createKeywordTypeNode(SyntaxKind.StringKeyword);
    case 'number':
      return createKeywordTypeNode(SyntaxKind.NumberKeyword);
    case 'boolean':
      return createKeywordTypeNode(SyntaxKind.BooleanKeyword);
    case 'void':
      return createKeywordTypeNode(SyntaxKind.VoidKeyword);
    case 'any':
      return createKeywordTypeNode(SyntaxKind.AnyKeyword);
    default:
      return createTypeReferenceNode(createIdentifier(type), undefined);
  }
}

/**
 * Builds a ParameterDeclaration AST node from a parameter descriptor or string.
 *
 * @param {string | object} param - Parameter name or descriptor object.
 * @param {string} [param.name] - Parameter name.
 * @param {string | object} [param.type] - Parameter type.
 * @param {'public' | 'private' | 'protected'} [param.access] - Parameter property access modifier.
 * @param {boolean} [param.isReadonly=false] - Whether parameter is readonly property.
 * @param {boolean} [param.isOptional=false] - Whether parameter is optional.
 * @param {object} [param.initializer] - Default value initializer expression.
 * @returns {object} ParameterDeclaration AST node.
 */
export function buildParameter(param) {
  if (typeof param === 'string') {
    return createParameterDeclaration(
      undefined,
      undefined,
      createIdentifier(param),
      undefined,
      undefined,
      undefined
    );
  }
  const nameNode = typeof param.name === 'string' ? createIdentifier(param.name) : param.name;
  const typeNode = toTypeNode(param.type);
  const questionToken = param.isOptional ? createToken(SyntaxKind.QuestionToken) : undefined;

  const modifiers = [];
  if (param.access === 'public') {
    modifiers.push(createToken(SyntaxKind.PublicKeyword));
  } else if (param.access === 'private') {
    modifiers.push(createToken(SyntaxKind.PrivateKeyword));
  } else if (param.access === 'protected') {
    modifiers.push(createToken(SyntaxKind.ProtectedKeyword));
  }
  if (param.isReadonly) {
    modifiers.push(createToken(SyntaxKind.ReadonlyKeyword));
  }

  return createParameterDeclaration(
    modifiers.length > 0 ? modifiers : undefined,
    undefined,
    nameNode,
    questionToken,
    typeNode,
    param.initializer
  );
}

/**
 * Builds a ConstructorDeclaration AST node using createConstructorDeclaration.
 *
 * @param {Array<string | object>} [parameters=[]] - Parameter declarations or descriptors.
 * @param {Array<object> | null} [bodyStatements=[]] - Statements for constructor body block. If null/undefined when isSignature is true, creates a signature/ambient constructor declaration without a body.
 * @param {object} [options={}] - Constructor options and modifiers.
 * @param {'public' | 'private' | 'protected'} [options.access] - Constructor access modifier.
 * @param {boolean} [options.isSignature=false] - Whether this is an overload/ambient signature without a body.
 * @returns {object} ConstructorDeclaration AST node.
 */
export function buildConstructorDeclaration(parameters = [], bodyStatements = [], options = {}) {
  const paramNodes = parameters.map((p) => (isParameterDeclaration(p) ? p : buildParameter(p)));

  const modifiers = [];
  if (options.access === 'public') {
    modifiers.push(createToken(SyntaxKind.PublicKeyword));
  } else if (options.access === 'private') {
    modifiers.push(createToken(SyntaxKind.PrivateKeyword));
  } else if (options.access === 'protected') {
    modifiers.push(createToken(SyntaxKind.ProtectedKeyword));
  }

  let bodyBlock = undefined;
  if (!options.isSignature && bodyStatements !== null && bodyStatements !== undefined) {
    bodyBlock = Array.isArray(bodyStatements) ? createBlock(bodyStatements, true) : bodyStatements;
  }

  return createConstructorDeclaration(
    modifiers.length > 0 ? modifiers : undefined,
    undefined,
    paramNodes,
    undefined,
    bodyBlock
  );
}

/**
 * Builds a class declaration containing a constructor declaration.
 *
 * @param {string | object} name - Class name or identifier.
 * @param {object} constructorNode - ConstructorDeclaration AST node.
 * @param {Array<object>} [otherMembers=[]] - Other class member AST nodes.
 * @returns {object} ClassDeclaration AST node.
 */
export function buildClassWithConstructor(name, constructorNode, otherMembers = []) {
  const nameNode = typeof name === 'string' ? createIdentifier(name) : name;
  const members = [constructorNode, ...otherMembers];
  return createClassDeclaration(undefined, nameNode, undefined, undefined, members);
}

/**
 * Inspects a ConstructorDeclaration AST node and extracts its metadata.
 *
 * @param {object} node - ConstructorDeclaration AST node.
 * @returns {object} Inspected constructor metadata.
 */
export function inspectConstructorDeclaration(node) {
  if (!node || typeof node !== 'object' || !isConstructorDeclaration(node)) {
    throw new TypeError('Expected a ConstructorDeclaration AST node');
  }

  const modifiers = Array.isArray(node.modifiers) ? node.modifiers : [];
  const isPublic = modifiers.some((m) => m.kind === SyntaxKind.PublicKeyword);
  const isPrivate = modifiers.some((m) => m.kind === SyntaxKind.PrivateKeyword);
  const isProtected = modifiers.some((m) => m.kind === SyntaxKind.ProtectedKeyword);

  const parameters = [];
  const rawParams = Array.isArray(node.parameters) ? node.parameters : [];
  for (const p of rawParams) {
    if (isParameterDeclaration(p)) {
      const pName = p.name && isIdentifier(p.name) ? p.name.text : undefined;
      const pModifiers = Array.isArray(p.modifiers) ? p.modifiers : [];
      const pIsPublic = pModifiers.some((m) => m.kind === SyntaxKind.PublicKeyword);
      const pIsPrivate = pModifiers.some((m) => m.kind === SyntaxKind.PrivateKeyword);
      const pIsProtected = pModifiers.some((m) => m.kind === SyntaxKind.ProtectedKeyword);
      const pIsReadonly = pModifiers.some((m) => m.kind === SyntaxKind.ReadonlyKeyword);
      const isOptional = p.questionToken !== undefined && p.questionToken.kind === SyntaxKind.QuestionToken;
      const hasInitializer = p.initializer !== undefined;

      let access = undefined;
      if (pIsPublic) access = 'public';
      else if (pIsPrivate) access = 'private';
      else if (pIsProtected) access = 'protected';

      parameters.push({
        name: pName,
        isOptional,
        isReadonly: pIsReadonly,
        access,
        hasInitializer,
      });
    }
  }

  const hasBody = node.body !== undefined && isBlock(node.body);
  const statementCount = hasBody && Array.isArray(node.body.statements) ? node.body.statements.length : 0;

  return {
    kind: node.kind,
    kindName: formatSyntaxKind(node.kind),
    isConstructorDeclaration: true,
    isPublic,
    isPrivate,
    isProtected,
    hasBody,
    statementCount,
    parameterCount: parameters.length,
    parameters,
  };
}

export {
  createConstructorDeclaration,
  createClassDeclaration,
  createParameterDeclaration,
  createBlock,
  createIdentifier,
  createToken,
  createKeywordExpression,
  createKeywordTypeNode,
  createTypeReferenceNode,
  createExpressionStatement,
  createBinaryExpression,
  createPropertyAccessExpression,
  createCallExpression,
  createReturnStatement,
  createStringLiteral,
  createNumericLiteral,
  isConstructorDeclaration,
  isClassDeclaration,
  isParameterDeclaration,
  isBlock,
  isIdentifier,
  isToken,
  isKeywordTypeNode,
  isTypeReferenceNode,
  SyntaxKind,
  formatSyntaxKind,
};

test/contract.mjs

import assert from 'node:assert/strict';
import {
  buildConstructorDeclaration,
  buildParameter,
  buildClassWithConstructor,
  inspectConstructorDeclaration,
  createConstructorDeclaration,
  createClassDeclaration,
  createParameterDeclaration,
  createBlock,
  createIdentifier,
  createToken,
  createKeywordExpression,
  createKeywordTypeNode,
  createTypeReferenceNode,
  createExpressionStatement,
  createBinaryExpression,
  createPropertyAccessExpression,
  createCallExpression,
  isConstructorDeclaration,
  isClassDeclaration,
  isParameterDeclaration,
  isBlock,
  SyntaxKind,
  formatSyntaxKind,
} from '../src/index.mjs';

// Contract 1: buildConstructorDeclaration constructs a constructor AST node with parameters and body statements using createConstructorDeclaration and validates it with isConstructorDeclaration
{
  const assignStmt = createExpressionStatement(
    createBinaryExpression(
      createPropertyAccessExpression(createKeywordExpression(SyntaxKind.ThisKeyword), createIdentifier('name')),
      createToken(SyntaxKind.EqualsToken),
      createIdentifier('name')
    )
  );

  const ctor = buildConstructorDeclaration(
    [{ name: 'name', type: 'string' }],
    [assignStmt]
  );

  assert.ok(ctor, 'Constructor node should be defined');
  assert.strictEqual(isConstructorDeclaration(ctor), true, 'Node should satisfy isConstructorDeclaration');
  assert.strictEqual(formatSyntaxKind(ctor.kind), 'Constructor', 'Kind name should be Constructor');
  assert.strictEqual(ctor.parameters.length, 1, 'Constructor should have 1 parameter');
  assert.strictEqual(ctor.parameters[0].name.text, 'name', 'Parameter name should match');
  assert.strictEqual(isBlock(ctor.body), true, 'Constructor body should be a block');
  assert.strictEqual(ctor.body.statements.length, 1, 'Constructor body should contain 1 statement');
}

// Contract 2: buildConstructorDeclaration constructs constructor declarations with access modifiers and parameter property modifiers (public, private, protected, readonly)
{
  const idParam = buildParameter({
    name: 'id',
    type: 'string',
    access: 'public',
    isReadonly: true,
  });
  const secretParam = buildParameter({
    name: 'secret',
    type: 'string',
    access: 'private',
  });
  const countParam = buildParameter({
    name: 'count',
    type: 'number',
    access: 'protected',
    isOptional: true,
  });

  const ctor = buildConstructorDeclaration(
    [idParam, secretParam, countParam],
    [],
    { access: 'protected' }
  );

  assert.ok(ctor, 'Constructor node should be defined');
  assert.strictEqual(isConstructorDeclaration(ctor), true, 'Should satisfy isConstructorDeclaration');
  assert.strictEqual(ctor.parameters.length, 3, 'Should have 3 parameters');

  // Verify constructor modifier
  assert.ok(
    ctor.modifiers && ctor.modifiers.some((m) => m.kind === SyntaxKind.ProtectedKeyword),
    'Constructor should have protected modifier'
  );

  // Verify first parameter (public readonly id: string)
  const p0Modifiers = ctor.parameters[0].modifiers || [];
  assert.ok(p0Modifiers.some((m) => m.kind === SyntaxKind.PublicKeyword), 'Param 0 should be public');
  assert.ok(p0Modifiers.some((m) => m.kind === SyntaxKind.ReadonlyKeyword), 'Param 0 should be readonly');

  // Verify second parameter (private secret: string)
  const p1Modifiers = ctor.parameters[1].modifiers || [];
  assert.ok(p1Modifiers.some((m) => m.kind === SyntaxKind.PrivateKeyword), 'Param 1 should be private');

  // Verify third parameter (protected count?: number)
  const p2Modifiers = ctor.parameters[2].modifiers || [];
  assert.ok(p2Modifiers.some((m) => m.kind === SyntaxKind.ProtectedKeyword), 'Param 2 should be protected');
  assert.strictEqual(ctor.parameters[2].questionToken.kind, SyntaxKind.QuestionToken, 'Param 2 should be optional');
}

// Contract 3: buildConstructorDeclaration supports overload signature declarations without body blocks using isSignature option
{
  const signatureCtor = buildConstructorDeclaration(
    [{ name: 'initialValue', type: 'string' }],
    null,
    { isSignature: true }
  );

  assert.ok(signatureCtor, 'Signature constructor should be defined');
  assert.strictEqual(isConstructorDeclaration(signatureCtor), true, 'Should satisfy isConstructorDeclaration');
  assert.strictEqual(signatureCtor.parameters.length, 1, 'Should have 1 parameter');
  assert.strictEqual(signatureCtor.body, undefined, 'Body should be undefined for overload signature');
}

// Contract 4: buildClassWithConstructor embeds constructor declarations inside a class AST node and validates constructor member hierarchy
{
  const superCall = createExpressionStatement(
    createCallExpression(createKeywordExpression(SyntaxKind.SuperKeyword), undefined, undefined, [])
  );
  const ctor = buildConstructorDeclaration(
    [{ name: 'config', type: 'any' }],
    [superCall],
    { access: 'public' }
  );

  const cls = buildClassWithConstructor('ServiceManager', ctor);

  assert.ok(cls, 'Class node should be defined');
  assert.strictEqual(isClassDeclaration(cls), true, 'Node should satisfy isClassDeclaration');
  assert.strictEqual(cls.name.text, 'ServiceManager', 'Class name should match');
  assert.strictEqual(cls.members.length, 1, 'Class should contain 1 member');
  assert.strictEqual(isConstructorDeclaration(cls.members[0]), true, 'First member should be ConstructorDeclaration');
}

// Contract 5: inspectConstructorDeclaration extracts constructor metadata, parameter details, and modifier flags using AST type guards
{
  const ctor = buildConstructorDeclaration(
    [
      { name: 'host', type: 'string', access: 'public', isReadonly: true },
      { name: 'port', type: 'number', isOptional: true },
    ],
    [
      createExpressionStatement(
        createBinaryExpression(
          createPropertyAccessExpression(createKeywordExpression(SyntaxKind.ThisKeyword), createIdentifier('initialized')),
          createToken(SyntaxKind.EqualsToken),
          createIdentifier('true')
        )
      ),
    ],
    { access: 'public' }
  );

  const info = inspectConstructorDeclaration(ctor);

  assert.strictEqual(info.isConstructorDeclaration, true, 'isConstructorDeclaration should be true');
  assert.strictEqual(info.kindName, 'Constructor', 'kindName should be Constructor');
  assert.strictEqual(info.isPublic, true, 'isPublic should be true');
  assert.strictEqual(info.isPrivate, false, 'isPrivate should be false');
  assert.strictEqual(info.isProtected, false, 'isProtected should be false');
  assert.strictEqual(info.hasBody, true, 'hasBody should be true');
  assert.strictEqual(info.statementCount, 1, 'statementCount should be 1');
  assert.strictEqual(info.parameterCount, 2, 'parameterCount should be 2');

  assert.strictEqual(info.parameters[0].name, 'host', 'Param 0 name should match');
  assert.strictEqual(info.parameters[0].access, 'public', 'Param 0 access should be public');
  assert.strictEqual(info.parameters[0].isReadonly, true, 'Param 0 isReadonly should be true');
  assert.strictEqual(info.parameters[0].isOptional, false, 'Param 0 isOptional should be false');

  assert.strictEqual(info.parameters[1].name, 'port', 'Param 1 name should match');
  assert.strictEqual(info.parameters[1].isOptional, true, 'Param 1 isOptional should be true');

  assert.throws(
    () => inspectConstructorDeclaration(null),
    { name: 'TypeError' },
    'inspectConstructorDeclaration should throw TypeError on null input'
  );
  assert.throws(
    () => inspectConstructorDeclaration({ kind: 999 }),
    { name: 'TypeError' },
    'inspectConstructorDeclaration should throw TypeError on non-constructor node'
  );
}

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

原始种子者

匿名