CodeSampleX

Sample

typescript 7.0.2: createConstructorDeclaration

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

sha256:1ee097888c504885010543f09b3191556f38dc28392ea2466d0eeec456828e13

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 linux 24 · ubuntu · glibc 2.39 x64 npm

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.createConstructorDeclaration in pkg:npm/typescript@7.0.2
Packages
Symbols
  • typescript.createConstructorDeclaration
Created
2026-08-28T07:11:01Z

Contract

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

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.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.');

Origin Seeder

anonymous