@intentius/chant-lexicon-aws 0.1.4 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-aws",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "description": "AWS CloudFormation lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -36,18 +36,18 @@
     "./types": "./dist/types/index.d.ts"
   },
   "scripts": {
-    "generate": "bun run src/codegen/generate-cli.ts",
-    "bundle": "bun run src/package-cli.ts",
-    "validate": "bun run src/validate-cli.ts",
-    "docs": "bun run src/codegen/docs-cli.ts",
-    "prepack": "bun run generate && bun run bundle && bun run validate"
+    "generate": "tsx src/codegen/generate-cli.ts",
+    "bundle": "tsx src/package-cli.ts",
+    "validate": "tsx src/validate-cli.ts",
+    "docs": "tsx src/codegen/docs-cli.ts",
+    "prepack": "npm run generate && npm run bundle && npm run validate"
   },
   "dependencies": {
     "fflate": "^0.8.2",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {
-    "@intentius/chant": "0.1.4",
+    "@intentius/chant": "*",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {

package/src/actions/actions.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { S3Actions } from "./s3";
 import { LambdaActions } from "./lambda";
 import { DynamoDBActions } from "./dynamodb";

package/src/codegen/__snapshots__/snapshot.test.ts.snap

@@ -1,6 +1,24 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
 
-exports[`snapshot tests Bucket lexicon entry 1`] = `
+exports[`snapshot tests > Bucket .d.ts class declaration 1`] = `
+"export declare class Bucket {
+  constructor(props: {
+    /** A name for the bucket. */
+    BucketName: string;
+    /** The Amazon Resource Name (ARN) of the bucket. */
+    Arn?: string;
+    /** Specifies default encryption for a bucket. */
+    BucketEncryption?: Bucket_BucketEncryption;
+    /** An arbitrary set of tags (key-value pairs) for this S3 bucket. */
+    Tags?: Bucket_Tag[];
+    /** Enables multiple versions of all objects in this bucket. */
+    VersioningConfiguration?: Bucket_VersioningConfiguration;
+  }, attributes?: CFResourceAttributes);
+  readonly Arn: string;
+}"
+`;
+
+exports[`snapshot tests > Bucket lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -24,7 +42,29 @@ exports[`snapshot tests Bucket lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests Function lexicon entry 1`] = `
+exports[`snapshot tests > Function .d.ts class declaration 1`] = `
+"export declare class Function {
+  constructor(props: {
+    /** The code for the function. */
+    Code: Function_Code;
+    /** The ARN of the function's execution role. */
+    Role: string;
+    /** The ARN of the function. */
+    Arn?: string;
+    /** The name of the Lambda function. */
+    FunctionName?: string;
+    /** The name of the method within your code that Lambda calls to run your function. */
+    Handler?: string;
+    /** The amount of memory available to the function at runtime. */
+    MemorySize?: number;
+    /** The identifier of the function's runtime. */
+    Runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
+  }, attributes?: CFResourceAttributes);
+  readonly Arn: string;
+}"
+`;
+
+exports[`snapshot tests > Function lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -76,7 +116,7 @@ exports[`snapshot tests Function lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests Role lexicon entry 1`] = `
+exports[`snapshot tests > Role lexicon entry 1`] = `
 {
   "attrs": {
     "Arn": "Arn",
@@ -98,7 +138,7 @@ exports[`snapshot tests Role lexicon entry 1`] = `
 }
 `;
 
-exports[`snapshot tests generated resource names 1`] = `
+exports[`snapshot tests > generated resource names 1`] = `
 [
   "Api",
   "Api_Auth",
@@ -155,43 +195,3 @@ exports[`snapshot tests generated resource names 1`] = `
   "VpcConfig",
 ]
 `;
-
-exports[`snapshot tests Bucket .d.ts class declaration 1`] = `
-"export declare class Bucket {
-  constructor(props: {
-    /** A name for the bucket. */
-    BucketName: string;
-    /** The Amazon Resource Name (ARN) of the bucket. */
-    Arn?: string;
-    /** Specifies default encryption for a bucket. */
-    BucketEncryption?: Bucket_BucketEncryption;
-    /** An arbitrary set of tags (key-value pairs) for this S3 bucket. */
-    Tags?: Bucket_Tag[];
-    /** Enables multiple versions of all objects in this bucket. */
-    VersioningConfiguration?: Bucket_VersioningConfiguration;
-  }, attributes?: CFResourceAttributes);
-  readonly Arn: string;
-}"
-`;
-
-exports[`snapshot tests Function .d.ts class declaration 1`] = `
-"export declare class Function {
-  constructor(props: {
-    /** The code for the function. */
-    Code: Function_Code;
-    /** The ARN of the function's execution role. */
-    Role: string;
-    /** The ARN of the function. */
-    Arn?: string;
-    /** The name of the Lambda function. */
-    FunctionName?: string;
-    /** The name of the method within your code that Lambda calls to run your function. */
-    Handler?: string;
-    /** The amount of memory available to the function at runtime. */
-    MemorySize?: number;
-    /** The identifier of the function's runtime. */
-    Runtime?: "java17" | "java21" | "nodejs18.x" | "nodejs20.x" | "python3.11" | "python3.12";
-  }, attributes?: CFResourceAttributes);
-  readonly Arn: string;
-}"
-`;

package/src/codegen/docs-links.test.ts

@@ -1,9 +1,9 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync, readdirSync, readFileSync } from "fs";
 import { join, basename } from "path";
 
-const docsDir = join(import.meta.dir, "..", "..", "docs", "src", "content", "docs");
-const docsSource = join(import.meta.dir, "docs.ts");
+const docsDir = join(import.meta.dirname, "..", "..", "docs", "src", "content", "docs");
+const docsSource = join(import.meta.dirname, "docs.ts");
 const docsExist = existsSync(docsDir);
 
 /**

package/src/codegen/docs.ts

@@ -488,12 +488,16 @@ When you need to split resources into a separate CloudFormation template, the le
         title: "Nested Stacks",
         sidebar: false,
         description: "Splitting resources into child CloudFormation templates with automatic cross-stack reference wiring",
-        content: `CloudFormation nested stacks (\`AWS::CloudFormation::Stack\`) let you decompose large templates into smaller, reusable child templates. The AWS lexicon's \`nestedStack()\` function references a **child project directory** — a subdirectory that builds independently to a valid CloudFormation template.
+        content: `import Diagram from '../../components/Diagram.astro';
+
+CloudFormation nested stacks (\`AWS::CloudFormation::Stack\`) let you decompose large templates into smaller, reusable child templates. The AWS lexicon's \`nestedStack()\` function references a **child project directory** — a subdirectory that builds independently to a valid CloudFormation template.
 
 :::caution[Consider alternatives first]
-Nested stacks add deployment complexity: child templates must be uploaded to S3, rollbacks are all-or-nothing at the parent level, drift detection doesn't recurse into children, and debugging failures requires drilling into child stack events. For most projects, [flat composites](../composites/) are simpler. Nested stacks are supported for specific cases — exceeding CloudFormation's 500-resource limit or packaging reusable infrastructure as a black box — but are not the recommended default.
+Nested stacks add deployment complexity: child templates must be uploaded to S3, rollbacks are all-or-nothing at the parent level, drift detection doesn't recurse into children, and debugging failures requires drilling into child stack events. For splitting a large project into separately-deployed pieces, prefer [Multi-Stack Projects](/chant/guide/multi-stack/) — each \`src/\` subdirectory becomes an independent stack with no parent orchestration and no S3 upload step. Nested stacks are supported for specific cases — exceeding CloudFormation's 500-resource limit inside a single deployable unit, or packaging reusable infrastructure for other teams to deploy as a black box — but are not the recommended default.
 :::
 
+<Diagram name="nested-stacks" alt="Parent and child project source directories producing separate CloudFormation templates, both uploaded to S3" caption="Nested stack source layout and output" />
+
 ## Project structure
 
 A nested stack is a child project — a subdirectory with its own resource files and explicit \`stackOutput()\` declarations:
@@ -611,14 +615,15 @@ Three lint rules help catch common nested stack issues:
 
 ## When to use nested stacks
 
-**Prefer flat composites** for most projects. Composites expand into a single template, deploy atomically, and are simpler to debug.
+Most splitting use cases are better served by other mechanisms:
 
-**Use nested stacks only when:**
-- Your template exceeds CloudFormation's 500-resource limit
-- You're packaging reusable infrastructure for other teams to deploy as a black box
-- You need independent update/rollback boundaries (rare — this usually means the resources should be separate stacks entirely)
+- **Splitting a large project into separately-deployed pieces** → [Multi-Stack Projects](/chant/guide/multi-stack/). Organize \`src/\` into subdirectories — each becomes an independent stack, deployed on its own, with cross-stack references resolved via standard CloudFormation \`Export\`/\`ImportValue\`. No parent template, no S3 upload of children, no \`TemplateBasePath\` parameter.
+- **Reusing resource patterns within a single template** → [Composites](../composites/). Composites expand into the same template and deploy atomically — they're about DRY, not splitting.
 
-See [Composites](../composites/) for the flat composite approach.`,
+**Use nested stacks only when:**
+- A single deployable unit exceeds CloudFormation's 500-resource limit
+- You're packaging reusable infrastructure for other teams to consume as a black box (the parent-child relationship is load-bearing)
+- You need an orchestrator parent that coordinates child lifecycles via CloudFormation Parameters and Outputs specifically`,
       },
       {
         slug: "lint-rules",
@@ -902,10 +907,10 @@ The \`plugins\` array accepts relative paths. Each plugin module should export a
 
 \`\`\`bash
 cd examples/lambda-function
-bun install
+npm install
 chant build    # produces CloudFormation JSON
 chant lint     # runs lint rules
-bun test       # runs the example's tests
+npx vitest run    # run the tests
 \`\`\`
 
 ## Lambda Function

package/src/codegen/generate-cli.ts

@@ -1,6 +1,6 @@
-#!/usr/bin/env bun
+#!/usr/bin/env tsx
 /**
- * Thin entry point for `bun run generate` in lexicon-aws.
+ * Thin entry point for `npm run generate` in lexicon-aws.
  */
 import { generate, writeGeneratedFiles } from "./generate";
 import { dirname } from "path";

package/src/codegen/generate.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate, writeGeneratedFiles } from "./generate";
 import { NamingStrategy } from "./naming";
 import { samResources } from "./sam";

package/src/codegen/idempotency.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate } from "./generate";
 import { loadSchemaFixtures } from "../testdata/load-fixtures";
 

package/src/codegen/package.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { packageLexicon } from "./package";
 import { validateManifest } from "@intentius/chant/lexicon-schema";
 

package/src/codegen/package.ts

@@ -3,9 +3,8 @@
  * with AWS-specific manifest building and skill collection.
  */
 
-import { createRequire } from "module";
 import { readFileSync } from "fs";
-const require = createRequire(import.meta.url);
+import { awsPlugin } from "../plugin";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import type { IntrinsicDef } from "@intentius/chant/lexicon";
@@ -43,8 +42,6 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
 
       buildManifest: (_genResult) => {
         // Lazy-import to avoid circular dependency
-        const { awsPlugin } = require("../plugin");
-
         const intrinsics: IntrinsicDef[] = (awsPlugin.intrinsics?.() ?? []).map(
           (i: { name: string; description: string }) => ({
             name: i.name,
@@ -73,9 +70,7 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
 
       srcDir: pkgDir,
 
-      collectSkills: () => {
-        const { awsPlugin } = require("../plugin");
-        const skillDefs = awsPlugin.skills?.() ?? [];
+      collectSkills: () => {        const skillDefs = awsPlugin.skills?.() ?? [];
         return collectSkills(skillDefs);
       },
 

package/src/codegen/snapshot.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { generate } from "./generate";
 import { loadSchemaFixtures } from "../testdata/load-fixtures";
 

package/src/codegen/typecheck.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { typecheckDTS } from "./typecheck";
 
 describe("typecheckDTS", () => {

package/src/composites/composites.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect, beforeEach } from "bun:test";
+import { describe, test, expect, beforeEach } from "vitest";
 import { expandComposite, CompositeRegistry, isCompositeInstance } from "@intentius/chant";
 import { AttrRef } from "@intentius/chant/attrref";
 import { LambdaFunction, LambdaNode, LambdaPython, NodeLambda, PythonLambda } from "./lambda-function";

package/src/coverage.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { existsSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";

package/src/default-tags.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect } from "bun:test";
+import { describe, test, expect } from "vitest";
 import { DECLARABLE_MARKER } from "@intentius/chant/declarable";
 import { defaultTags, isDefaultTags, DEFAULT_TAGS_MARKER } from "./default-tags";