@azure/provisioning-core 0.1.0-alpha.20261014.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# `@azure/provisioning-core`
+
+The runtime for authoring Azure infrastructure in TypeScript: resource trees, symbolic expressions, shared configuration, and JSON serialization. Creating or editing these objects changes a deployment definition, not live Azure resources.
+
+Start with [Getting started](../../docs/getting-started.md) for a walkthrough using core and service classes such as `StorageAccount` and `KeyVault`.
+
+## Major features
+
+### Resource authoring
+
+A deployment definition is a tree of `ProvisioningComponent` objects. `Stack`, `Resource`, and concrete resource classes such as `StorageAccount` are direct or indirect subclasses of it. Each building block links to its source implementation:
+
+- [ProvisioningComponent](src/constructs/provisioning-component.ts) - the base class for tree nodes, providing parent-child tracking, inherited deployment context, traversal, and transformations. You can create your own subclass to group related resources, apply shared configuration, and expose resource handles as a reusable component. The component itself does not declare an Azure resource.
+- [Stack](src/constructs/stack.ts) - the root component of a definition, holding resources and deployment inputs and outputs.
+- [Resource](src/constructs/resource/resource.ts) - the base for service classes and generic ARM declarations, including existing references, conditions, and dependencies. Writable properties can be edited after construction and before serialization; read-only properties remain available as references.
+- [ResourceGroup](src/constructs/built-in-resources/resource-group.ts) - a built-in Azure resource that also provides a parent context for its resources.
+- [Deployment context](src/deployment-context/deployment-context.ts) - carries inherited location, tags, and naming policy through the component tree. The nearest ancestor supplies location and policy; ancestor tags are merged with nearer values taking precedence.
+- [Naming](src/naming/naming-policy.ts) - generates omitted resource names through a configurable policy, using [resource naming rules](src/naming/naming-rules.ts) that describe Azure length, character, and uniqueness requirements. These rules guide name generation; explicit names are used unchanged.
+- [Parameters](src/constructs/parameter.ts) - inputs supplied at deployment, with optional defaults and constraints.
+- [Variables](src/constructs/variable.ts) - named values or expressions shared within the definition.
+- [Outputs](src/constructs/output.ts) - values returned by the deployment, such as a resource ID.
+- [Resource queries](src/constructs/resource/resource-query.ts) - find authored objects by type or literal name so they can be inspected and edited without querying Azure.
+
+**Read more**
+
+- [Getting started](../../docs/getting-started.md#define-a-stack-and-resources) - construct and configure resources through the public APIs.
+- [Configure resource properties](../../docs/getting-started.md#configure-resource-properties) - edit writable properties or replace nested objects before serialization.
+- [Infrastructure authoring model](../../docs/authoring-model.md) - resource relationships and reusable components.
+- [Names and shared defaults](../../docs/authoring-model.md#names-and-shared-defaults) - naming policies, inherited settings, and resource-level overrides.
+- [Parameters, variables, and outputs](../../docs/getting-started.md#parameters-variables-and-outputs) - declare deployment values through stack collections.
+
+### Functions and expressions
+
+Connect resource settings to parameters, calculations, and other resources even when their values are not yet known. Core preserves these relationships as deployment-time expressions rather than evaluating them in JavaScript.
+
+- [Function helpers](src/fn.ts) - `fn` builds symbolic operations such as concatenation, comparisons, and resource-ID calculations.
+- [Expression types](src/expression/expressions.ts) - `Expression<T>` and `ExpressionOrValue<T>` describe symbolic and literal values; generated input/view types use core's typing contracts to support nested authoring.
+- [Resource property expressions](src/constructs/resource/resource-proxy.ts) - use resource properties as deployment-time expressions to connect resources, such as passing one resource's ID to another resource's input.
+
+**Read more**
+
+- [Working with expressions](../../docs/getting-started.md#work-with-expressions) - authoring calculations and resource references.
+- [Provisioning type system](../../contributing/internals/provisioning-type-system.md) - input/view types and expression assignability.
+- [Proxy system](../../contributing/internals/proxy-system.md) - how core supports expressions on resource properties through ordinary TypeScript property access.
+
+### Serialization and restoration
+
+[serialize](src/serialization/json/serialize.ts) converts the tree, values, and references into a JSON-compatible document. [deserialize](src/serialization/json/deserialize.ts) reconstructs supported resource objects so they can be queried, edited, and serialized again. Three pieces support this round trip:
+
+- [Serialization contract](src/serialization/contract/index.ts) - defines the cross-language JSON format for exchanging provisioning definitions between TypeScript and .NET, so both sides interpret resource declarations, values, and references consistently.
+- [Runtime shapes](src/shape/shape.ts) - retain client-to-ARM property mappings, nested types, and encoding metadata after TypeScript erasure, guiding value conversion in both directions.
+- [Resource registration](src/constructs/resource/resource-type-registry.ts) - resolves registered classes and shapes by resource type, API version, and variant. Load the relevant service packages before restoration so their registrations are available.
+
+**Read more**
+
+- [Changing the serialization contract](../../contributing/workflows/change-schema-files.md) - contract source, generation, and affected consumers.
+- [Runtime shapes and registration](../../contributing/internals/service-packages.md#runtime-shapes-and-registration) - property mappings and concrete resource classes.
+- [Serialization and restoration](../../contributing/internals/serialization-roundtrip.md) - the round-trip workflow and its limitations.
+
+## Related packages
+
+For how service classes, their types, and runtime metadata are produced, see [Service package anatomy](../../contributing/internals/service-packages.md) and the [TypeSpec emitter overview](../../contributing/internals/emitter-overview.md).

package/dist/constructs/built-in-resources/resource-group.d.ts

@@ -0,0 +1,50 @@
+import type { ProvisioningComponent } from "../provisioning-component.js";
+import { type Expression, type ExpressionOrValue, type InputRecord } from "../../expression/expressions.js";
+import type { ResourceNamingRules } from "../../naming/naming-rules.js";
+import type { ExistingResourceProps } from "../resource/resource.js";
+import { Resource } from "../resource/resource.js";
+export interface ResourceGroupProps {
+    name?: ExpressionOrValue<string> | undefined;
+    location: ExpressionOrValue<string>;
+    tags?: Record<string, ExpressionOrValue<string>>;
+    managedBy?: ExpressionOrValue<string>;
+}
+/**
+ * An Azure resource group that establishes a deployment boundary.
+ *
+ * @remarks
+ * Resources created with a `ResourceGroup` as their parent inherit its
+ * location, tags, and naming policy, and deploy at resource-group scope
+ * in the generated Bicep.
+ *
+ * @example
+ * ```typescript
+ * import { Stack, ResourceGroup } from "@azure/provisioning-core";
+ * import { KeyVault } from "@azure/provisioning-keyvault";
+ *
+ * const stack = new Stack("my-app");
+ * const rg = new ResourceGroup(stack, { location: "eastus" });
+ * const vault = new KeyVault(rg, {
+ *   properties: { tenantId: "...", sku: { family: "A", name: "standard" } },
+ * });
+ * ```
+ */
+export declare class ResourceGroup extends Resource<"Microsoft.Resources/resourceGroups"> {
+    static readonly resourceType: "Microsoft.Resources/resourceGroups";
+    static readonly apiVersion = "2024-03-01";
+    protected static namingRules: ResourceNamingRules;
+    constructor(context: ProvisioningComponent, props: (ResourceGroupProps & {
+        existing?: false;
+    }) | (ExistingResourceProps & {
+        existing: true;
+    }));
+    /** The resource group's location as an expression. */
+    get location(): Expression<string>;
+    set location(value: ExpressionOrValue<string>);
+    get managedBy(): Expression<string>;
+    set managedBy(value: ExpressionOrValue<string> | undefined);
+    get tags(): InputRecord<ExpressionOrValue<string>, Record<string, string>> | undefined;
+    set tags(value: InputRecord<ExpressionOrValue<string>, Record<string, string>> | undefined);
+    add<T extends new (context: ProvisioningComponent, ...args: any[]) => ProvisioningComponent>(ctor: T, ...args: ConstructorParameters<T> extends [any, ...infer Rest] ? Rest : never): InstanceType<T>;
+}
+//# sourceMappingURL=resource-group.d.ts.map

package/dist/constructs/built-in-resources/resource-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-group.d.ts","sourceRoot":"","sources":["../../../src/constructs/built-in-resources/resource-group.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAoBnD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,aAAc,SAAQ,QAAQ,CAAC,oCAAoC,CAAC;IAC/E,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAG,oCAAoC,CAAU;IAC7E,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAE1C,SAAS,CAAC,MAAM,CAAC,WAAW,sBAA4B;gBAkBtD,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EACD,CAAC,kBAAkB,GAAG;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,GAC3C,CAAC,qBAAqB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAmBlD,sDAAsD;IACtD,IAAI,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,CAEjC;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAE5C;IAED,IAAI,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,CAElC;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,SAAS,EAEzD;IAED,IAAI,IAAI,IACJ,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9D,SAAS,CAOZ;IACD,IAAI,IAAI,CACN,KAAK,EACD,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC9D,SAAS,EAGd;IAED,GAAG,CACD,CAAC,SAAS,KACR,OAAO,EAAE,qBAAqB,EAC9B,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,qBAAqB,EAE1B,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,GAC1D,IAAI,GACJ,KAAK,GACR,YAAY,CAAC,CAAC,CAAC;CAGnB"}

package/dist/constructs/built-in-resources/resource-group.js

@@ -0,0 +1,97 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import * as fn from "../../fn.js";
+import {} from "../../expression/expressions.js";
+import { deref } from "../resource/resource-proxy.js";
+import { Resource } from "../resource/resource.js";
+import { createFlatModelShape, createRecordShape, createStringShape, } from "../../shape/shape.js";
+const resourceGroupNamingRules = {
+    abbreviation: "rg",
+    minLength: 1,
+    maxLength: 90,
+    validCharacters: {
+        uppercase: true,
+        hyphens: true,
+        underscores: true,
+        periods: true,
+    },
+    scope: "subscription",
+};
+/**
+ * An Azure resource group that establishes a deployment boundary.
+ *
+ * @remarks
+ * Resources created with a `ResourceGroup` as their parent inherit its
+ * location, tags, and naming policy, and deploy at resource-group scope
+ * in the generated Bicep.
+ *
+ * @example
+ * ```typescript
+ * import { Stack, ResourceGroup } from "@azure/provisioning-core";
+ * import { KeyVault } from "@azure/provisioning-keyvault";
+ *
+ * const stack = new Stack("my-app");
+ * const rg = new ResourceGroup(stack, { location: "eastus" });
+ * const vault = new KeyVault(rg, {
+ *   properties: { tenantId: "...", sku: { family: "A", name: "standard" } },
+ * });
+ * ```
+ */
+export class ResourceGroup extends Resource {
+    static resourceType = "Microsoft.Resources/resourceGroups";
+    static apiVersion = "2024-03-01";
+    static namingRules = resourceGroupNamingRules;
+    static {
+        this.registerShape(createFlatModelShape({
+            name: { armPath: ["name"], value: createStringShape() },
+            location: { armPath: ["location"], value: createStringShape() },
+            tags: {
+                armPath: ["tags"],
+                value: createRecordShape(createStringShape()),
+            },
+            managedBy: { armPath: ["managedBy"], value: createStringShape() },
+        }));
+        this.register();
+    }
+    constructor(context, props) {
+        super(context, {
+            ...props,
+            type: ResourceGroup.resourceType,
+            apiVersion: ResourceGroup.apiVersion,
+        });
+        this._localDeploymentContext = {
+            // Resources inside this RG deploy at RG scope, so the canonical
+            // default is the Bicep runtime expression `resourceGroup().location`
+            // (i.e. the actual location of whichever RG hosts the deployment).
+            // This is correct whether the RG is authored locally or referenced
+            // as `existing`.
+            location: fn.resourceGroup().location,
+            tags: deref(this.tags),
+        };
+    }
+    /** The resource group's location as an expression. */
+    get location() {
+        return this.expr("location");
+    }
+    set location(value) {
+        this.setProperty("location", value);
+    }
+    get managedBy() {
+        return this.expr("managedBy");
+    }
+    set managedBy(value) {
+        this.setProperty("managedBy", value);
+    }
+    get tags() {
+        return this.state.tags === undefined
+            ? undefined
+            : this.expr("tags");
+    }
+    set tags(value) {
+        this.setProperty("tags", value);
+    }
+    add(ctor, ...args) {
+        return new ctor(this.self, ...args);
+    }
+}
+//# sourceMappingURL=resource-group.js.map

package/dist/constructs/built-in-resources/resource-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-group.js","sourceRoot":"","sources":["../../../src/constructs/built-in-resources/resource-group.ts"],"names":[],"mappings":"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"}

package/dist/constructs/output.d.ts

@@ -0,0 +1,80 @@
+import type { PrimitiveTypeMap, PrimitiveTypeName } from "../serialization/contract/index.js";
+import type { ExpressionOrValue, InputOf } from "../expression/expressions.js";
+import type { Resource } from "./resource/resource.js";
+import type { Stack } from "./stack.js";
+/**
+ * A value accepted as a deployment output's value: any JSON literal (scalar,
+ * `null`, array, object — recursively), an `Expression`, a resource view
+ * (`InputOf<unknown>`), or a {@link Resource} handle. The literal members are
+ * required so plain object/array literals are accepted (a bare
+ * `InputOf<unknown>` is a weak type and would reject them).
+ */
+export type OutputValue = string | number | boolean | null | readonly OutputValue[] | {
+    readonly [key: string]: OutputValue;
+} | InputOf<unknown> | Resource;
+/** Primitive Bicep type names supported by deployment outputs. */
+export type OutputType = PrimitiveTypeName;
+export type ScalarOutputType = "string" | "int" | "bool";
+export type OutputValueFor<T extends OutputType> = T extends ScalarOutputType ? ExpressionOrValue<PrimitiveTypeMap[T]> : OutputValue;
+export type OutputOptions = {
+    readonly description?: string | undefined;
+    readonly secure?: boolean | undefined;
+    readonly minValue?: number | undefined;
+    readonly maxValue?: number | undefined;
+    readonly minLength?: number | undefined;
+    readonly maxLength?: number | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
+    readonly discriminator?: string | undefined;
+    readonly sealed?: boolean | undefined;
+};
+/**
+ * Pure declaration data for a deployment output. Stored on the stack and read
+ * by the serializer at emit time. An output is a terminal sink — it has no
+ * expression handle.
+ */
+export interface OutputMetadata extends OutputOptions {
+    readonly name: string;
+    readonly type: OutputType;
+    readonly value: OutputValue;
+}
+/**
+ * Authoring-time collection of a stack's deployment outputs. Backed by an
+ * ordered private array; supports add/get/delete/iteration. Outputs are
+ * terminal sinks (no expression handle), so iteration yields metadata.
+ */
+export declare class OutputCollection {
+    #private;
+    /** Add an output. Throws on duplicate name. Returns the stored metadata. */
+    add<T extends OutputType>(name: string, type: T, value: OutputValueFor<NoInfer<T>>, options?: OutputOptions): OutputMetadata;
+    /** The declaration metadata for an output, or `undefined`. */
+    get(name: string): OutputMetadata | undefined;
+    /** All output metadata, in insertion order. */
+    list(): readonly OutputMetadata[];
+    has(name: string): boolean;
+    /** Remove an output by name. Returns whether one was removed. */
+    delete(name: string): boolean;
+    get size(): number;
+    [Symbol.iterator](): IterableIterator<OutputMetadata>;
+}
+/**
+ * A deployment output, compiled to a Bicep `output` declaration.
+ *
+ * @example
+ * ```typescript
+ * import { Stack } from "@azure/provisioning-core";
+ * import { KeyVault } from "@azure/provisioning-keyvault";
+ *
+ * const stack = new Stack("my-app", { targetScope: "resourceGroup" });
+ * const vault = new KeyVault(stack, {
+ *   name: "kv-my-app",
+ *   location: "eastus",
+ *   properties: {
+ *     tenantId: "11111111-1111-1111-1111-111111111111",
+ *     sku: { family: "A", name: "standard" },
+ *   },
+ * });
+ * stack.outputs.add("vaultUri", "string", vault.properties.vaultUri);
+ * ```
+ */
+export declare function createOutput<T extends OutputType>(stack: Stack, name: string, type: T, value: OutputValueFor<NoInfer<T>>, options?: OutputOptions): OutputMetadata;
+//# sourceMappingURL=output.d.ts.map

package/dist/constructs/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/constructs/output.ts"],"names":[],"mappings":"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"}

package/dist/constructs/output.js

@@ -0,0 +1,76 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { isResource } from "./resource/resource-utils.js";
+import { assertBicepIdentifier, assertValueAssignableToType } from "../util.js";
+/**
+ * Authoring-time collection of a stack's deployment outputs. Backed by an
+ * ordered private array; supports add/get/delete/iteration. Outputs are
+ * terminal sinks (no expression handle), so iteration yields metadata.
+ */
+export class OutputCollection {
+    #entries = [];
+    /** Add an output. Throws on duplicate name. Returns the stored metadata. */
+    add(name, type, value, options) {
+        assertBicepIdentifier(name, "Deployment output");
+        if (this.has(name)) {
+            throw new Error(`Duplicate deployment output name: ${name}`);
+        }
+        if ((type === "string" || type === "int" || type === "bool") &&
+            isResource(value)) {
+            throw new Error(`Deployment output "${name}" expected type "${type}" but got resource.`);
+        }
+        assertValueAssignableToType(value, type, `Deployment output "${name}"`);
+        const metadata = { name, type, value, ...options };
+        this.#entries.push(metadata);
+        return metadata;
+    }
+    /** The declaration metadata for an output, or `undefined`. */
+    get(name) {
+        return this.#entries.find((e) => e.name === name);
+    }
+    /** All output metadata, in insertion order. */
+    list() {
+        return this.#entries;
+    }
+    has(name) {
+        return this.get(name) !== undefined;
+    }
+    /** Remove an output by name. Returns whether one was removed. */
+    delete(name) {
+        const i = this.#entries.findIndex((e) => e.name === name);
+        if (i === -1)
+            return false;
+        this.#entries.splice(i, 1);
+        return true;
+    }
+    get size() {
+        return this.#entries.length;
+    }
+    [Symbol.iterator]() {
+        return this.#entries[Symbol.iterator]();
+    }
+}
+/**
+ * A deployment output, compiled to a Bicep `output` declaration.
+ *
+ * @example
+ * ```typescript
+ * import { Stack } from "@azure/provisioning-core";
+ * import { KeyVault } from "@azure/provisioning-keyvault";
+ *
+ * const stack = new Stack("my-app", { targetScope: "resourceGroup" });
+ * const vault = new KeyVault(stack, {
+ *   name: "kv-my-app",
+ *   location: "eastus",
+ *   properties: {
+ *     tenantId: "11111111-1111-1111-1111-111111111111",
+ *     sku: { family: "A", name: "standard" },
+ *   },
+ * });
+ * stack.outputs.add("vaultUri", "string", vault.properties.vaultUri);
+ * ```
+ */
+export function createOutput(stack, name, type, value, options) {
+    return stack.outputs.add(name, type, value, options);
+}
+//# sourceMappingURL=output.js.map

package/dist/constructs/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/constructs/output.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAQlC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAkDhF;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAC3B,QAAQ,GAAqB,EAAE,CAAC;IAEhC,4EAA4E;IAC5E,GAAG,CACD,IAAY,EACZ,IAAO,EACP,KAAiC,EACjC,OAAuB;QAEvB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IACE,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,CAAC;YACxD,UAAU,CAAC,KAAK,CAAC,EACjB,CAAC;YACD,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,oBAAoB,IAAI,qBAAqB,CACxE,CAAC;QACJ,CAAC;QACD,2BAA2B,CAAC,KAAK,EAAE,IAAI,EAAE,sBAAsB,IAAI,GAAG,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;QACnE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,8DAA8D;IAC9D,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,+CAA+C;IAC/C,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;IACtC,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,IAAY;QACjB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1C,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,IAAY,EACZ,IAAO,EACP,KAAiC,EACjC,OAAuB;IAEvB,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC"}

package/dist/constructs/parameter.d.ts

@@ -0,0 +1,77 @@
+import type { PrimitiveTypeMap } from "../serialization/contract/index.js";
+import type { Expression, ExpressionOrValue } from "../expression/expressions.js";
+import type { Stack } from "./stack.js";
+export type InferParamType<T extends keyof PrimitiveTypeMap, A> = A extends readonly (infer E)[] ? E : PrimitiveTypeMap[T];
+/**
+ * A value accepted as a parameter's `defaultValue`: a literal of the declared
+ * type or an `Expression` of it. Resource views are intentionally excluded —
+ * a Bicep `param` default cannot reference resources.
+ */
+export type ParameterValue<T extends keyof PrimitiveTypeMap = keyof PrimitiveTypeMap> = ExpressionOrValue<PrimitiveTypeMap[T]>;
+export type ParameterOptions<T extends keyof PrimitiveTypeMap = keyof PrimitiveTypeMap, A extends readonly PrimitiveTypeMap[T][] | undefined = undefined> = {
+    readonly defaultValue?: ExpressionOrValue<InferParamType<T, A>> | undefined;
+    readonly description?: string | undefined;
+    readonly secure?: boolean | undefined;
+    readonly minValue?: number | undefined;
+    readonly maxValue?: number | undefined;
+    readonly minLength?: number | undefined;
+    readonly maxLength?: number | undefined;
+    readonly metadata?: Record<string, unknown> | undefined;
+    readonly allowed?: A;
+    readonly discriminator?: string | undefined;
+    readonly sealed?: boolean | undefined;
+};
+/**
+ * Pure declaration data for a deployment parameter. Stored on the stack
+ * (paired with the returned expression handle in {@link ParameterEntry});
+ * read by the serializer at emit time. Not part of the value-level handle.
+ */
+export interface ParameterMetadata extends ParameterOptions<keyof PrimitiveTypeMap, readonly PrimitiveTypeMap[keyof PrimitiveTypeMap][] | undefined> {
+    readonly name: string;
+    readonly type: keyof PrimitiveTypeMap;
+}
+export type Parameter<T extends keyof PrimitiveTypeMap = keyof PrimitiveTypeMap, A extends readonly PrimitiveTypeMap[T][] | undefined = undefined> = Expression<InferParamType<T, A>>;
+/**
+ * Authoring-time collection of a stack's deployment parameters. Backed by an
+ * ordered private array; supports add/get/delete/iteration. Look parameters up
+ * by name via {@link ParameterCollection.get}.
+ */
+export declare class ParameterCollection {
+    #private;
+    /** Add a parameter; returns its expression handle. Throws on duplicate name. */
+    add<T extends keyof PrimitiveTypeMap = keyof PrimitiveTypeMap, const A extends readonly PrimitiveTypeMap[T][] | undefined = undefined>(name: string, type: T, options?: ParameterOptions<T, A>): Parameter<T, A>;
+    /** The expression handle for a parameter, or `undefined`. */
+    get(name: string): Parameter | undefined;
+    /** The declaration metadata for a parameter, or `undefined`. */
+    getMetadata(name: string): ParameterMetadata | undefined;
+    /** All parameter handles, in insertion order. */
+    list(): readonly Parameter[];
+    /** All declaration metadata, in insertion order. */
+    listMetadata(): readonly ParameterMetadata[];
+    has(name: string): boolean;
+    /** Remove a parameter by name. Returns whether one was removed. */
+    delete(name: string): boolean;
+    get size(): number;
+    [Symbol.iterator](): IterableIterator<Parameter>;
+}
+/**
+ * A deploy-time input to a stack, compiled to a Bicep `param` declaration.
+ *
+ * @remarks
+ * The returned value is an `Expression` that can be passed to resource
+ * properties. At deploy time, the user supplies the actual value. The
+ * declaration metadata is stored separately on the stack, keyed by name.
+ *
+ * @example
+ * ```typescript
+ * import { Stack, createParameter } from "@azure/provisioning-core";
+ *
+ * const stack = new Stack("my-app", { targetScope: "resourceGroup" });
+ * const env = createParameter(stack, "env", "string", {
+ *   allowed: ["dev", "staging", "prod"] as const,
+ *   defaultValue: "dev",
+ * });
+ * ```
+ */
+export declare function createParameter<T extends keyof PrimitiveTypeMap = keyof PrimitiveTypeMap, const A extends readonly PrimitiveTypeMap[T][] | undefined = undefined>(stack: Stack, name: string, type: T, options?: ParameterOptions<T, A>): Parameter<T, A>;
+//# sourceMappingURL=parameter.d.ts.map

package/dist/constructs/parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.d.ts","sourceRoot":"","sources":["../../src/constructs/parameter.ts"],"names":[],"mappings":"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"}

package/dist/constructs/parameter.js

@@ -0,0 +1,93 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { wrapExpression } from "../expression/expressions.js";
+import { isExpression } from "../expression/expressions.js";
+import { symbolicValueExpressionNode } from "../expression/ast-nodes.js";
+import { assertBicepIdentifier, assertValueAssignableToType } from "../util.js";
+/**
+ * Authoring-time collection of a stack's deployment parameters. Backed by an
+ * ordered private array; supports add/get/delete/iteration. Look parameters up
+ * by name via {@link ParameterCollection.get}.
+ */
+export class ParameterCollection {
+    #entries = [];
+    /** Add a parameter; returns its expression handle. Throws on duplicate name. */
+    add(name, type, options) {
+        assertBicepIdentifier(name, "Deployment parameter");
+        if (this.has(name)) {
+            throw new Error(`Duplicate deployment parameter name: ${name}`);
+        }
+        assertValueAssignableToType(options?.defaultValue, type, `Deployment parameter "${name}"`);
+        if (options?.defaultValue !== undefined &&
+            !isExpression(options.defaultValue) &&
+            options.allowed !== undefined &&
+            !options.allowed.includes(options.defaultValue)) {
+            throw new Error(`Deployment parameter "${name}" default value must be one of its allowed values.`);
+        }
+        const param = wrapExpression(symbolicValueExpressionNode(name));
+        this.#entries.push({
+            metadata: { name, type, ...options },
+            parameter: param,
+        });
+        return param;
+    }
+    /** The expression handle for a parameter, or `undefined`. */
+    get(name) {
+        return this.#find(name)?.parameter;
+    }
+    /** The declaration metadata for a parameter, or `undefined`. */
+    getMetadata(name) {
+        return this.#find(name)?.metadata;
+    }
+    /** All parameter handles, in insertion order. */
+    list() {
+        return this.#entries.map((e) => e.parameter);
+    }
+    /** All declaration metadata, in insertion order. */
+    listMetadata() {
+        return this.#entries.map((e) => e.metadata);
+    }
+    has(name) {
+        return this.#find(name) !== undefined;
+    }
+    /** Remove a parameter by name. Returns whether one was removed. */
+    delete(name) {
+        const i = this.#entries.findIndex((e) => e.metadata.name === name);
+        if (i === -1)
+            return false;
+        this.#entries.splice(i, 1);
+        return true;
+    }
+    get size() {
+        return this.#entries.length;
+    }
+    [Symbol.iterator]() {
+        return this.#entries.map((e) => e.parameter)[Symbol.iterator]();
+    }
+    #find(name) {
+        return this.#entries.find((e) => e.metadata.name === name);
+    }
+}
+/**
+ * A deploy-time input to a stack, compiled to a Bicep `param` declaration.
+ *
+ * @remarks
+ * The returned value is an `Expression` that can be passed to resource
+ * properties. At deploy time, the user supplies the actual value. The
+ * declaration metadata is stored separately on the stack, keyed by name.
+ *
+ * @example
+ * ```typescript
+ * import { Stack, createParameter } from "@azure/provisioning-core";
+ *
+ * const stack = new Stack("my-app", { targetScope: "resourceGroup" });
+ * const env = createParameter(stack, "env", "string", {
+ *   allowed: ["dev", "staging", "prod"] as const,
+ *   defaultValue: "dev",
+ * });
+ * ```
+ */
+export function createParameter(stack, name, type, options) {
+    return stack.parameters.add(name, type, options);
+}
+//# sourceMappingURL=parameter.js.map

package/dist/constructs/parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter.js","sourceRoot":"","sources":["../../src/constructs/parameter.ts"],"names":[],"mappings":"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"}