@resistdesign/voltra 3.0.0-alpha.6 → 3.0.0-alpha.8

package/README.md

@@ -21,9 +21,9 @@ Prefer the public entrypoints below to keep imports stable and IDE auto-imports
 Preferred:
 
 ```ts
-import { IaC } from "@resistdesign/voltra";
-import { Packs } from "@resistdesign/voltra/iac";
-import { addDNS } from "@resistdesign/voltra/iac/packs";
+import {IaC} from "@resistdesign/voltra";
+import {Packs} from "@resistdesign/voltra/iac";
+import {addDNS} from "@resistdesign/voltra/iac/packs";
 ```
 
 Not supported:
@@ -41,6 +41,30 @@ Public entrypoints:
 - `@resistdesign/voltra/iac`
 - `@resistdesign/voltra/iac/packs`
 
+------------
+
+## Build-time Type Parsing (Advanced)
+
+Voltra exposes TypeScript compiler–powered parsing utilities intended **only for build-time tooling** (scripts,
+generators, CI).
+
+These APIs depend on the TypeScript compiler and **must not be imported into runtime code** (e.g. Lambdas, servers,
+browsers).
+
+Build entrypoint:
+
+```ts
+import {getTypeInfoMapFromTypeScript} from "@resistdesign/voltra/build";
+```
+
+Use this entrypoint for:
+
+- Code generation
+- Pre-build analysis
+- Producing static artifacts (JSON / TS)
+
+Do **not** import `@resistdesign/voltra/build` from runtime code.
+
 ## With our powers combined!
 
 <table style="border: 0 solid black;">
@@ -74,8 +98,10 @@ The docs site is both reference documentation and a canonical usage example.
 Key pieces:
 
 - Astro app in `site/app` builds the UI into `site-dist/app` via `yarn site:build:app`.
-- API bundle for the docs site is built by `yarn site:build:api` (see `site/build-api.mjs`) and written to `site-dist/api`.
-- The IaC demo template is generated by `yarn site:build:iac` from `site/iac/index.ts` and written to `site-dist/iac/index.yml`.
+- API bundle for the docs site is built by `yarn site:build:api` (see `site/build-api.mjs`) and written to
+  `site-dist/api`.
+- The IaC demo template is generated by `yarn site:build:iac` from `site/iac/index.ts` and written to
+  `site-dist/iac/index.yml`.
 
 API docs flow:
 
@@ -89,12 +115,15 @@ IaC types are generated from the AWS CloudFormation resource specification.
 When updating, follow this flow:
 
 1) Download the latest CloudFormation resource specification JSON from AWS (region: `us-east-1`).
-2) Replace the contents of `src/iac/types/CloudFormationResourceSpecification.ts` with the JSON payload (as the exported data).
+2) Replace the contents of `src/iac/types/CloudFormationResourceSpecification.ts` with the JSON payload (as the exported
+   data).
 3) Run `yarn iac:types:gen` to regenerate `dist/IaCTypes.ts`.
 4) Verify `dist/IaCTypes.ts` looks correct, then commit both files.
 
 Notes:
-- `src/iac/types/IaCTypes.ts` and `src/iac/types/CloudFormationResourceSpecification.ts` are generated artifacts; do not edit by hand.
+
+- `src/iac/types/IaCTypes.ts` and `src/iac/types/CloudFormationResourceSpecification.ts` are generated artifacts; do not
+  edit by hand.
 - The generator entrypoint is `src/iac/types/generate.ts` and uses `src/iac/types/Renderers.ts` for output.
 
 ## Releasing

package/api/index.d.ts

@@ -1,4 +1,4 @@
-export { D as DAC, a as Indexing, b as ORM, c as Routing } from '../index-DbLgMAxB.js';
+export { D as DAC, a as Indexing, b as ORM, c as Routing } from '../index-t9LXRpCu.js';
 import '@aws-sdk/client-dynamodb';
 import '@aws-sdk/client-s3';
 import '../SearchTypes-DjN6YQzE.js';