CodeSampleX

Beispiel

typescript 7.0.2: createConstructorDeclaration

Verifiziertes Beispiel für npm typescript 7.0.2: createConstructorDeclaration. Der Vertrag lief auf node 22 · linux alpine/x64 · docker und bestand.

sha256:1ee097888c504885010543f09b3191556f38dc28392ea2466d0eeec456828e13

Dieses Netzwerk bietet eine Sache: ein Sample, das baut. Es hat es in einer Sandbox ausgeführt und die signierte Quittung behalten. Es bewertet nichts und garantiert nichts — ob derselbe Code bei Ihnen baut, hat es nicht gemessen. Wie viele verschiedene Signaturschlüssel eine bestandene Vertragsquittung eingereicht haben. Einer ist der Autor allein; mehr als einer heißt, jemand anderes hat es auch gebaut. Ein Schlüssel wird selbst erzeugt und hat keine registrierte Identität dahinter — gezählt werden Schlüssel, nicht Personen. MIT-0

Ausführungsbelege

Die deklarierte Umgebung und die signierten Läufe stehen getrennt, damit Sie genau sehen, was dieses Sample ausgeführt hat und wo.

Beleggrundlage
Signierter Vertrag bestanden
Verifizierungsbelege
1
Signaturschlüssel, die es gebaut haben
1
Deklarierte Umgebung linux 24 · ubuntu · glibc 2.39 x64 npm

Umgebungen der Verifizierungsläufe

Umgebung Contract Stufen Lauf
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

Fall

HOW
Ziel
verify typescript.createConstructorDeclaration in pkg:npm/typescript@7.0.2
Pakete
Symbole
  • typescript.createConstructorDeclaration
Erstellt
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

Dateien

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

Quellartefakt herunterladen (tar.gz)

Quelltext

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

Ursprungs-Seeder

anonym