@azure/provisioning-core 1.0.0-beta.1

package/dist/browser/shape/value-encoding.js

@@ -0,0 +1,32 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export const INTEGER_SCALAR_NAMES = [
+    "integer",
+    "safeint",
+    "int8",
+    "int16",
+    "int32",
+    "int64",
+    "uint8",
+    "uint16",
+    "uint32",
+    "uint64",
+];
+export const NUMERIC_SCALAR_NAMES = [
+    ...INTEGER_SCALAR_NAMES,
+    "numeric",
+    "decimal",
+    "decimal128",
+    "float",
+    "float32",
+    "float64",
+];
+const integerScalarNames = new Set(INTEGER_SCALAR_NAMES);
+const numericScalarNames = new Set(NUMERIC_SCALAR_NAMES);
+export function isIntegerScalarName(name) {
+    return integerScalarNames.has(name);
+}
+export function isNumericScalarName(name) {
+    return numericScalarNames.has(name);
+}
+//# sourceMappingURL=value-encoding.js.map

package/dist/browser/shape/value-encoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-encoding.js","sourceRoot":"","sources":["../../../src/shape/value-encoding.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,oBAAoB;IACvB,SAAS;IACT,SAAS;IACT,YAAY;IACZ,OAAO;IACP,SAAS;IACT,SAAS;CACD,CAAC;AAIX,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAC9E,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE9E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nexport const INTEGER_SCALAR_NAMES = [\n  \"integer\",\n  \"safeint\",\n  \"int8\",\n  \"int16\",\n  \"int32\",\n  \"int64\",\n  \"uint8\",\n  \"uint16\",\n  \"uint32\",\n  \"uint64\",\n] as const;\n\nexport type IntegerScalarName = (typeof INTEGER_SCALAR_NAMES)[number];\n\nexport const NUMERIC_SCALAR_NAMES = [\n  ...INTEGER_SCALAR_NAMES,\n  \"numeric\",\n  \"decimal\",\n  \"decimal128\",\n  \"float\",\n  \"float32\",\n  \"float64\",\n] as const;\n\nexport type NumericScalarName = (typeof NUMERIC_SCALAR_NAMES)[number];\n\nconst integerScalarNames: ReadonlySet<string> = new Set(INTEGER_SCALAR_NAMES);\nconst numericScalarNames: ReadonlySet<string> = new Set(NUMERIC_SCALAR_NAMES);\n\nexport function isIntegerScalarName(name: string): name is IntegerScalarName {\n  return integerScalarNames.has(name);\n}\n\nexport function isNumericScalarName(name: string): name is NumericScalarName {\n  return numericScalarNames.has(name);\n}\n\nexport interface DateTimeTextEncodingDescriptor {\n  readonly kind: \"date-time-text\";\n  readonly source: \"utcDateTime\" | \"offsetDateTime\";\n  readonly format: \"rfc3339\" | \"rfc7231\";\n  readonly clientMode: \"client\" | \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport interface UnixTimestampEncodingDescriptor {\n  readonly kind: \"unix-timestamp\";\n  readonly source: \"utcDateTime\";\n  readonly unit: \"seconds\";\n  readonly clientMode: \"client\" | \"wire\";\n  readonly wire: {\n    readonly kind: \"integer\";\n    readonly scalar: IntegerScalarName;\n  };\n}\n\nexport interface DurationIso8601EncodingDescriptor {\n  readonly kind: \"duration-iso8601\";\n  readonly source: \"duration\";\n  readonly clientMode: \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport interface DurationNumericEncodingDescriptor {\n  readonly kind: \"duration-numeric\";\n  readonly source: \"duration\";\n  readonly unit: \"seconds\" | \"milliseconds\";\n  readonly clientMode: \"wire\";\n  readonly wire: {\n    readonly kind: \"integer\";\n    readonly scalar: IntegerScalarName;\n  };\n}\n\nexport interface BytesEncodingDescriptor {\n  readonly kind: \"bytes\";\n  readonly source: \"bytes\";\n  readonly format: \"base64\" | \"base64url\";\n  readonly clientMode: \"client\" | \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport interface PlainDateEncodingDescriptor {\n  readonly kind: \"plain-date\";\n  readonly source: \"plainDate\";\n  readonly clientMode: \"client\" | \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport interface NumericStringEncodingDescriptor {\n  readonly kind: \"numeric-string\";\n  readonly source: \"integer\" | \"number\";\n  readonly sourceScalar: NumericScalarName;\n  readonly clientMode: \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport interface BooleanStringEncodingDescriptor {\n  readonly kind: \"boolean-string\";\n  readonly source: \"boolean\";\n  readonly clientMode: \"client\" | \"wire\";\n  readonly wire: { readonly kind: \"string\" };\n}\n\nexport type ValueEncodingDescriptor =\n  | DateTimeTextEncodingDescriptor\n  | UnixTimestampEncodingDescriptor\n  | DurationIso8601EncodingDescriptor\n  | DurationNumericEncodingDescriptor\n  | BytesEncodingDescriptor\n  | PlainDateEncodingDescriptor\n  | NumericStringEncodingDescriptor\n  | BooleanStringEncodingDescriptor;\n\n/**\n * Encodings whose client-side value is a JavaScript `string`.\n *\n * The source TypeSpec scalar can be a date/time, duration, byte sequence,\n * numeric value, or boolean. `clientMode: \"wire\"` is the important invariant:\n * it means the generated TypeScript API exposes the encoded string itself.\n */\nexport type StringValueEncodingDescriptor =\n  | (DateTimeTextEncodingDescriptor & { readonly clientMode: \"wire\" })\n  | DurationIso8601EncodingDescriptor\n  | (BytesEncodingDescriptor & { readonly clientMode: \"wire\" })\n  | (PlainDateEncodingDescriptor & { readonly clientMode: \"wire\" })\n  | NumericStringEncodingDescriptor\n  | (BooleanStringEncodingDescriptor & { readonly clientMode: \"wire\" });\n\n/** Encoding supported by a client-side JavaScript `boolean`. */\nexport type BooleanValueEncodingDescriptor = BooleanStringEncodingDescriptor & {\n  readonly clientMode: \"client\";\n};\n\n/** Encodings whose client-side value is a JavaScript `number`. */\nexport type NumberValueEncodingDescriptor =\n  | (UnixTimestampEncodingDescriptor & { readonly clientMode: \"wire\" })\n  | DurationNumericEncodingDescriptor;\n\n/** Encoding supported by a client-side JavaScript `Uint8Array`. */\nexport type BytesValueEncodingDescriptor = BytesEncodingDescriptor & {\n  readonly clientMode: \"client\";\n};\n\n/**\n * Encodings whose client-side value is a JavaScript `Date`.\n *\n * `offsetDateTime` is intentionally absent: the emitter exposes it as a\n * string so the original offset is not erased.\n */\nexport type DateValueEncodingDescriptor =\n  | (DateTimeTextEncodingDescriptor & {\n      readonly source: \"utcDateTime\";\n      readonly clientMode: \"client\";\n    })\n  | (UnixTimestampEncodingDescriptor & { readonly clientMode: \"client\" })\n  | (PlainDateEncodingDescriptor & { readonly clientMode: \"client\" });\n"]}

package/dist/browser/types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * General-purpose type aliases used across the core package.
+ *
+ * Keep this file dependency-free so it can be imported from any layer
+ * (AST, proxy, resource, shape) without introducing cycles.
+ */
+/** A single member access segment: an object property name or an array index. */
+export type PropertySegment = string | number;
+//# sourceMappingURL=types.d.ts.map

package/dist/browser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/dist/browser/types.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * General-purpose type aliases used across the core package.\n *\n * Keep this file dependency-free so it can be imported from any layer\n * (AST, proxy, resource, shape) without introducing cycles.\n */\n\n/** A single member access segment: an object property name or an array index. */\nexport type PropertySegment = string | number;\n"]}

package/dist/browser/util.d.ts

@@ -0,0 +1,33 @@
+/** Reject declaration names that cannot be emitted as Bicep identifiers. */
+export declare function assertBicepIdentifier(name: string, kind: string): void;
+/**
+ * Filters an object to only include properties with defined (non-undefined) values.
+ * Useful for constructing objects with fixed types that use optional properties
+ * (e.g. InfraNode) where `exactOptionalPropertyTypes` prevents assigning undefined.
+ *
+ * Keys whose value type includes undefined become optional in the return type.
+ * Keys whose value type is exactly undefined are removed entirely.
+ */
+export declare function definedProps<T extends Record<string, unknown>>(obj: T): {
+    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+} & {
+    [K in keyof T as undefined extends T[K] ? (T[K] extends undefined ? never : K) : never]+?: Exclude<T[K], undefined>;
+};
+/**
+ * Asserts that a value is assignable to a primitive Bicep type
+ * (`string`, `int`, `bool`, `object`, `array`).
+ *
+ * @remarks
+ * The value may be a literal, an `Expression`, a resource view, or a
+ * `Resource`. Only **concrete literals** are validated; symbolic values
+ * (expressions / views / resources) are skipped because their type is
+ * enforced by the type system at author time. `undefined` and non-primitive
+ * (`any`/structural) types are also no-ops. Throws on a literal/type
+ * mismatch.
+ *
+ * @param value - The candidate value (literal or symbolic).
+ * @param type - The primitive Bicep type to check against.
+ * @param label - Optional prefix for the error message (e.g. the declaration).
+ */
+export declare function assertValueAssignableToType(value: unknown, type: string, label?: string): void;
+//# sourceMappingURL=util.d.ts.map

package/dist/browser/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAQA,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,GAAG,EAAE,CAAC,GACL;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG;KAEhE,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CACtF,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;CAC9B,CAEA;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA+B9F"}

package/dist/browser/util.js

@@ -0,0 +1,74 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { isExpression } from "./expression/expressions.js";
+import { isResource } from "./constructs/resource/resource-utils.js";
+const BICEP_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/u;
+/** Reject declaration names that cannot be emitted as Bicep identifiers. */
+export function assertBicepIdentifier(name, kind) {
+    if (!BICEP_IDENTIFIER.test(name)) {
+        throw new Error(`${kind} name "${name}" must be a valid Bicep identifier (letters, digits, and underscores; not starting with a digit).`);
+    }
+}
+/**
+ * Filters an object to only include properties with defined (non-undefined) values.
+ * Useful for constructing objects with fixed types that use optional properties
+ * (e.g. InfraNode) where `exactOptionalPropertyTypes` prevents assigning undefined.
+ *
+ * Keys whose value type includes undefined become optional in the return type.
+ * Keys whose value type is exactly undefined are removed entirely.
+ */
+export function definedProps(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+/**
+ * Asserts that a value is assignable to a primitive Bicep type
+ * (`string`, `int`, `bool`, `object`, `array`).
+ *
+ * @remarks
+ * The value may be a literal, an `Expression`, a resource view, or a
+ * `Resource`. Only **concrete literals** are validated; symbolic values
+ * (expressions / views / resources) are skipped because their type is
+ * enforced by the type system at author time. `undefined` and non-primitive
+ * (`any`/structural) types are also no-ops. Throws on a literal/type
+ * mismatch.
+ *
+ * @param value - The candidate value (literal or symbolic).
+ * @param type - The primitive Bicep type to check against.
+ * @param label - Optional prefix for the error message (e.g. the declaration).
+ */
+export function assertValueAssignableToType(value, type, label) {
+    if (value === undefined)
+        return;
+    if (isExpression(value) || isResource(value))
+        return;
+    const prefix = label ? `${label} ` : "";
+    const fail = (got) => {
+        throw new Error(`${prefix}expected type "${type}" but got ${got}.`);
+    };
+    switch (type) {
+        case "string":
+            if (typeof value !== "string")
+                fail(typeof value);
+            break;
+        case "int":
+            if (typeof value !== "number" || !Number.isInteger(value)) {
+                fail(typeof value === "number" ? "non-integer number" : typeof value);
+            }
+            break;
+        case "bool":
+            if (typeof value !== "boolean")
+                fail(typeof value);
+            break;
+        case "object":
+            if (typeof value !== "object" || value === null || Array.isArray(value)) {
+                fail(Array.isArray(value) ? "array" : value === null ? "null" : typeof value);
+            }
+            break;
+        case "array":
+            if (!Array.isArray(value))
+                fail(value === null ? "null" : typeof value);
+            break;
+        // "any" and other (structural) types: no runtime check.
+    }
+}
+//# sourceMappingURL=util.js.map

package/dist/browser/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAErE,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAErD,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAY;IAC9D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,UAAU,IAAI,mGAAmG,CACzH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAM;IAMN,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAQ,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAc,EAAE,IAAY,EAAE,KAAc;IACtF,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO;IAChC,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO;IAErD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAS,EAAE;QAClC,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,kBAAkB,IAAI,aAAa,GAAG,GAAG,CAAC,CAAC;IACtE,CAAC,CAAC;IAEF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;YAClD,MAAM;QACR,KAAK,KAAK;YACR,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1D,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;YACxE,CAAC;YACD,MAAM;QACR,KAAK,MAAM;YACT,IAAI,OAAO,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,KAAK,CAAC,CAAC;YACnD,MAAM;QACR,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;YAChF,CAAC;YACD,MAAM;QACR,KAAK,OAAO;YACV,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;YACxE,MAAM;QACR,wDAAwD;IAC1D,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { isExpression } from \"./expression/expressions.js\";\nimport { isResource } from \"./constructs/resource/resource-utils.js\";\n\nconst BICEP_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/u;\n\n/** Reject declaration names that cannot be emitted as Bicep identifiers. */\nexport function assertBicepIdentifier(name: string, kind: string): void {\n  if (!BICEP_IDENTIFIER.test(name)) {\n    throw new Error(\n      `${kind} name \"${name}\" must be a valid Bicep identifier (letters, digits, and underscores; not starting with a digit).`,\n    );\n  }\n}\n\n/**\n * Filters an object to only include properties with defined (non-undefined) values.\n * Useful for constructing objects with fixed types that use optional properties\n * (e.g. InfraNode) where `exactOptionalPropertyTypes` prevents assigning undefined.\n *\n * Keys whose value type includes undefined become optional in the return type.\n * Keys whose value type is exactly undefined are removed entirely.\n */\nexport function definedProps<T extends Record<string, unknown>>(\n  obj: T,\n): { [K in keyof T as undefined extends T[K] ? never : K]: T[K] } & {\n  [\n    K in keyof T as undefined extends T[K] ? (T[K] extends undefined ? never : K) : never\n  ]+?: Exclude<T[K], undefined>;\n} {\n  return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined)) as any;\n}\n\n/**\n * Asserts that a value is assignable to a primitive Bicep type\n * (`string`, `int`, `bool`, `object`, `array`).\n *\n * @remarks\n * The value may be a literal, an `Expression`, a resource view, or a\n * `Resource`. Only **concrete literals** are validated; symbolic values\n * (expressions / views / resources) are skipped because their type is\n * enforced by the type system at author time. `undefined` and non-primitive\n * (`any`/structural) types are also no-ops. Throws on a literal/type\n * mismatch.\n *\n * @param value - The candidate value (literal or symbolic).\n * @param type - The primitive Bicep type to check against.\n * @param label - Optional prefix for the error message (e.g. the declaration).\n */\nexport function assertValueAssignableToType(value: unknown, type: string, label?: string): void {\n  if (value === undefined) return;\n  if (isExpression(value) || isResource(value)) return;\n\n  const prefix = label ? `${label} ` : \"\";\n  const fail = (got: string): never => {\n    throw new Error(`${prefix}expected type \"${type}\" but got ${got}.`);\n  };\n\n  switch (type) {\n    case \"string\":\n      if (typeof value !== \"string\") fail(typeof value);\n      break;\n    case \"int\":\n      if (typeof value !== \"number\" || !Number.isInteger(value)) {\n        fail(typeof value === \"number\" ? \"non-integer number\" : typeof value);\n      }\n      break;\n    case \"bool\":\n      if (typeof value !== \"boolean\") fail(typeof value);\n      break;\n    case \"object\":\n      if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n        fail(Array.isArray(value) ? \"array\" : value === null ? \"null\" : typeof value);\n      }\n      break;\n    case \"array\":\n      if (!Array.isArray(value)) fail(value === null ? \"null\" : typeof value);\n      break;\n    // \"any\" and other (structural) types: no runtime check.\n  }\n}\n"]}

package/dist/commonjs/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 snippet:ignore
+ * 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/commonjs/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;AAgBnD,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,EACH,CAAC,kBAAkB,GAAG;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC,GAAG,CAAC,qBAAqB,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAmB9F,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,IAAI,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAIrF;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EAMzF;IAED,GAAG,CAAC,CAAC,SAAS,KAAK,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,qBAAqB,EACzF,IAAI,EAAE,CAAC,EACP,GAAG,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,GAC5E,YAAY,CAAC,CAAC,CAAC;CAGnB"}

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

@@ -0,0 +1,114 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var resource_group_exports = {};
+__export(resource_group_exports, {
+  ResourceGroup: () => ResourceGroup
+});
+module.exports = __toCommonJS(resource_group_exports);
+var fn = __toESM(require("../../fn.js"));
+var import_resource_proxy = require("../resource/resource-proxy.js");
+var import_resource = require("../resource/resource.js");
+var import_shape = require("../../shape/shape.js");
+const resourceGroupNamingRules = {
+  abbreviation: "rg",
+  minLength: 1,
+  maxLength: 90,
+  validCharacters: {
+    uppercase: true,
+    hyphens: true,
+    underscores: true,
+    periods: true
+  },
+  scope: "subscription"
+};
+class ResourceGroup extends import_resource.Resource {
+  static resourceType = "Microsoft.Resources/resourceGroups";
+  static apiVersion = "2024-03-01";
+  static namingRules = resourceGroupNamingRules;
+  static {
+    this.registerShape(
+      (0, import_shape.createFlatModelShape)({
+        name: { armPath: ["name"], value: (0, import_shape.createStringShape)() },
+        location: { armPath: ["location"], value: (0, import_shape.createStringShape)() },
+        tags: {
+          armPath: ["tags"],
+          value: (0, import_shape.createRecordShape)((0, import_shape.createStringShape)())
+        },
+        managedBy: { armPath: ["managedBy"], value: (0, import_shape.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: (0, import_resource_proxy.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 === void 0 ? void 0 : this.expr("tags");
+  }
+  set tags(value) {
+    this.setProperty("tags", value);
+    this._localDeploymentContext = {
+      ...this._localDeploymentContext,
+      tags: (0, import_resource_proxy.deref)(this.tags)
+    };
+  }
+  add(ctor, ...args) {
+    return new ctor(this.self, ...args);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ResourceGroup
+});
+//# sourceMappingURL=resource-group.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/constructs/built-in-resources/resource-group.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ProvisioningComponent } from \"../provisioning-component.js\";\nimport * as fn from \"../../fn.js\";\nimport {\n  type Expression,\n  type ExpressionOrValue,\n  type InputRecord,\n} from \"../../expression/expressions.js\";\nimport type { ResourceNamingRules } from \"../../naming/naming-rules.js\";\nimport { deref } from \"../resource/resource-proxy.js\";\nimport type { ExistingResourceProps } from \"../resource/resource.js\";\nimport { Resource } from \"../resource/resource.js\";\nimport { createFlatModelShape, createRecordShape, createStringShape } from \"../../shape/shape.js\";\n\nconst resourceGroupNamingRules: ResourceNamingRules = {\n  abbreviation: \"rg\",\n  minLength: 1,\n  maxLength: 90,\n  validCharacters: {\n    uppercase: true,\n    hyphens: true,\n    underscores: true,\n    periods: true,\n  },\n  scope: \"subscription\",\n};\n\nexport interface ResourceGroupProps {\n  name?: ExpressionOrValue<string> | undefined;\n  location: ExpressionOrValue<string>;\n  tags?: Record<string, ExpressionOrValue<string>>;\n  managedBy?: ExpressionOrValue<string>;\n}\n\n/**\n * An Azure resource group that establishes a deployment boundary.\n *\n * @remarks\n * Resources created with a `ResourceGroup` as their parent inherit its\n * location, tags, and naming policy, and deploy at resource-group scope\n * in the generated Bicep.\n *\n * @example\n * ```typescript snippet:ignore\n * import { Stack, ResourceGroup } from \"@azure/provisioning-core\";\n * import { KeyVault } from \"@azure/provisioning-keyvault\";\n *\n * const stack = new Stack(\"my-app\");\n * const rg = new ResourceGroup(stack, { location: \"eastus\" });\n * const vault = new KeyVault(rg, {\n *   properties: { tenantId: \"...\", sku: { family: \"A\", name: \"standard\" } },\n * });\n * ```\n */\nexport class ResourceGroup extends Resource<\"Microsoft.Resources/resourceGroups\"> {\n  static readonly resourceType = \"Microsoft.Resources/resourceGroups\" as const;\n  static readonly apiVersion = \"2024-03-01\";\n\n  protected static namingRules = resourceGroupNamingRules;\n\n  static {\n    this.registerShape(\n      createFlatModelShape({\n        name: { armPath: [\"name\"], value: createStringShape() },\n        location: { armPath: [\"location\"], value: createStringShape() },\n        tags: {\n          armPath: [\"tags\"],\n          value: createRecordShape(createStringShape()),\n        },\n        managedBy: { armPath: [\"managedBy\"], value: createStringShape() },\n      }),\n    );\n    this.register();\n  }\n\n  constructor(\n    context: ProvisioningComponent,\n    props:\n      (ResourceGroupProps & { existing?: false }) | (ExistingResourceProps & { existing: true }),\n  ) {\n    super(context, {\n      ...props,\n      type: ResourceGroup.resourceType,\n      apiVersion: ResourceGroup.apiVersion,\n    });\n\n    this._localDeploymentContext = {\n      // Resources inside this RG deploy at RG scope, so the canonical\n      // default is the Bicep runtime expression `resourceGroup().location`\n      // (i.e. the actual location of whichever RG hosts the deployment).\n      // This is correct whether the RG is authored locally or referenced\n      // as `existing`.\n      location: fn.resourceGroup().location,\n      tags: deref(this.tags),\n    };\n  }\n\n  /** The resource group's location as an expression. */\n  get location(): Expression<string> {\n    return this.expr(\"location\");\n  }\n  set location(value: ExpressionOrValue<string>) {\n    this.setProperty(\"location\", value);\n  }\n\n  get managedBy(): Expression<string> {\n    return this.expr(\"managedBy\");\n  }\n  set managedBy(value: ExpressionOrValue<string> | undefined) {\n    this.setProperty(\"managedBy\", value);\n  }\n\n  get tags(): InputRecord<ExpressionOrValue<string>, Record<string, string>> | undefined {\n    return this.state.tags === undefined\n      ? undefined\n      : (this.expr(\"tags\") as InputRecord<ExpressionOrValue<string>, Record<string, string>>);\n  }\n  set tags(value: InputRecord<ExpressionOrValue<string>, Record<string, string>> | undefined) {\n    this.setProperty(\"tags\", value);\n    this._localDeploymentContext = {\n      ...this._localDeploymentContext,\n      tags: deref(this.tags),\n    };\n  }\n\n  add<T extends new (context: ProvisioningComponent, ...args: any[]) => ProvisioningComponent>(\n    ctor: T,\n    ...args: ConstructorParameters<T> extends [any, ...infer Rest] ? Rest : never\n  ): InstanceType<T> {\n    return new ctor(this.self, ...args) as InstanceType<T>;\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,SAAoB;AAOpB,4BAAsB;AAEtB,sBAAyB;AACzB,mBAA2E;AAE3E,MAAM,2BAAgD;AAAA,EACpD,cAAc;AAAA,EACd,WAAW;AAAA,EACX,WAAW;AAAA,EACX,iBAAiB;AAAA,IACf,WAAW;AAAA,IACX,SAAS;AAAA,IACT,aAAa;AAAA,IACb,SAAS;AAAA,EACX;AAAA,EACA,OAAO;AACT;AA6BO,MAAM,sBAAsB,yBAA+C;AAAA,EAChF,OAAgB,eAAe;AAAA,EAC/B,OAAgB,aAAa;AAAA,EAE7B,OAAiB,cAAc;AAAA,EAE/B,OAAO;AACL,SAAK;AAAA,UACH,mCAAqB;AAAA,QACnB,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,WAAO,gCAAkB,EAAE;AAAA,QACtD,UAAU,EAAE,SAAS,CAAC,UAAU,GAAG,WAAO,gCAAkB,EAAE;AAAA,QAC9D,MAAM;AAAA,UACJ,SAAS,CAAC,MAAM;AAAA,UAChB,WAAO,oCAAkB,gCAAkB,CAAC;AAAA,QAC9C;AAAA,QACA,WAAW,EAAE,SAAS,CAAC,WAAW,GAAG,WAAO,gCAAkB,EAAE;AAAA,MAClE,CAAC;AAAA,IACH;AACA,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,YACE,SACA,OAEA;AACA,UAAM,SAAS;AAAA,MACb,GAAG;AAAA,MACH,MAAM,cAAc;AAAA,MACpB,YAAY,cAAc;AAAA,IAC5B,CAAC;AAED,SAAK,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAM7B,UAAU,GAAG,cAAc,EAAE;AAAA,MAC7B,UAAM,6BAAM,KAAK,IAAI;AAAA,IACvB;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAA+B;AACjC,WAAO,KAAK,KAAK,UAAU;AAAA,EAC7B;AAAA,EACA,IAAI,SAAS,OAAkC;AAC7C,SAAK,YAAY,YAAY,KAAK;AAAA,EACpC;AAAA,EAEA,IAAI,YAAgC;AAClC,WAAO,KAAK,KAAK,WAAW;AAAA,EAC9B;AAAA,EACA,IAAI,UAAU,OAA8C;AAC1D,SAAK,YAAY,aAAa,KAAK;AAAA,EACrC;AAAA,EAEA,IAAI,OAAmF;AACrF,WAAO,KAAK,MAAM,SAAS,SACvB,SACC,KAAK,KAAK,MAAM;AAAA,EACvB;AAAA,EACA,IAAI,KAAK,OAAmF;AAC1F,SAAK,YAAY,QAAQ,KAAK;AAC9B,SAAK,0BAA0B;AAAA,MAC7B,GAAG,KAAK;AAAA,MACR,UAAM,6BAAM,KAAK,IAAI;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,IACE,SACG,MACc;AACjB,WAAO,IAAI,KAAK,KAAK,MAAM,GAAG,IAAI;AAAA,EACpC;AACF;",
+  "names": []
+}

package/dist/commonjs/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 snippet:ignore
+ * 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/commonjs/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/commonjs/constructs/output.js

@@ -0,0 +1,75 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var output_exports = {};
+__export(output_exports, {
+  OutputCollection: () => OutputCollection,
+  createOutput: () => createOutput
+});
+module.exports = __toCommonJS(output_exports);
+var import_resource_utils = require("./resource/resource-utils.js");
+var import_util = require("../util.js");
+class OutputCollection {
+  #entries = [];
+  /** Add an output. Throws on duplicate name. Returns the stored metadata. */
+  add(name, type, value, options) {
+    (0, import_util.assertBicepIdentifier)(name, "Deployment output");
+    if (this.has(name)) {
+      throw new Error(`Duplicate deployment output name: ${name}`);
+    }
+    if ((type === "string" || type === "int" || type === "bool") && (0, import_resource_utils.isResource)(value)) {
+      throw new Error(`Deployment output "${name}" expected type "${type}" but got resource.`);
+    }
+    (0, import_util.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) !== void 0;
+  }
+  /** 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]();
+  }
+}
+function createOutput(stack, name, type, value, options) {
+  return stack.outputs.add(name, type, value, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OutputCollection,
+  createOutput
+});
+//# sourceMappingURL=output.js.map

package/dist/commonjs/constructs/output.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/constructs/output.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { PrimitiveTypeMap, PrimitiveTypeName } from \"../serialization/contract/index.js\";\nimport type { ExpressionOrValue, InputOf } from \"../expression/expressions.js\";\nimport type { Resource } from \"./resource/resource.js\";\nimport { isResource } from \"./resource/resource-utils.js\";\nimport type { Stack } from \"./stack.js\";\nimport { assertBicepIdentifier, assertValueAssignableToType } from \"../util.js\";\n\n/**\n * A value accepted as a deployment output's value: any JSON literal (scalar,\n * `null`, array, object \u2014 recursively), an `Expression`, a resource view\n * (`InputOf<unknown>`), or a {@link Resource} handle. The literal members are\n * required so plain object/array literals are accepted (a bare\n * `InputOf<unknown>` is a weak type and would reject them).\n */\nexport type OutputValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly OutputValue[]\n  | { readonly [key: string]: OutputValue }\n  | InputOf<unknown>\n  | Resource;\n\n/** Primitive Bicep type names supported by deployment outputs. */\nexport type OutputType = PrimitiveTypeName;\n\nexport type ScalarOutputType = \"string\" | \"int\" | \"bool\";\nexport type OutputValueFor<T extends OutputType> = T extends ScalarOutputType\n  ? ExpressionOrValue<PrimitiveTypeMap[T]>\n  : OutputValue;\n\nexport type OutputOptions = {\n  readonly description?: string | undefined;\n  readonly secure?: boolean | undefined;\n  readonly minValue?: number | undefined;\n  readonly maxValue?: number | undefined;\n  readonly minLength?: number | undefined;\n  readonly maxLength?: number | undefined;\n  readonly metadata?: Record<string, unknown> | undefined;\n  readonly discriminator?: string | undefined;\n  readonly sealed?: boolean | undefined;\n};\n\n/**\n * Pure declaration data for a deployment output. Stored on the stack and read\n * by the serializer at emit time. An output is a terminal sink \u2014 it has no\n * expression handle.\n */\nexport interface OutputMetadata extends OutputOptions {\n  readonly name: string;\n  readonly type: OutputType;\n  readonly value: OutputValue;\n}\n\n/**\n * Authoring-time collection of a stack's deployment outputs. Backed by an\n * ordered private array; supports add/get/delete/iteration. Outputs are\n * terminal sinks (no expression handle), so iteration yields metadata.\n */\nexport class OutputCollection {\n  #entries: OutputMetadata[] = [];\n\n  /** Add an output. Throws on duplicate name. Returns the stored metadata. */\n  add<T extends OutputType>(\n    name: string,\n    type: T,\n    value: OutputValueFor<NoInfer<T>>,\n    options?: OutputOptions,\n  ): OutputMetadata {\n    assertBicepIdentifier(name, \"Deployment output\");\n    if (this.has(name)) {\n      throw new Error(`Duplicate deployment output name: ${name}`);\n    }\n    if ((type === \"string\" || type === \"int\" || type === \"bool\") && isResource(value)) {\n      throw new Error(`Deployment output \"${name}\" expected type \"${type}\" but got resource.`);\n    }\n    assertValueAssignableToType(value, type, `Deployment output \"${name}\"`);\n    const metadata: OutputMetadata = { name, type, value, ...options };\n    this.#entries.push(metadata);\n    return metadata;\n  }\n\n  /** The declaration metadata for an output, or `undefined`. */\n  get(name: string): OutputMetadata | undefined {\n    return this.#entries.find((e) => e.name === name);\n  }\n\n  /** All output metadata, in insertion order. */\n  list(): readonly OutputMetadata[] {\n    return this.#entries;\n  }\n\n  has(name: string): boolean {\n    return this.get(name) !== undefined;\n  }\n\n  /** Remove an output by name. Returns whether one was removed. */\n  delete(name: string): boolean {\n    const i = this.#entries.findIndex((e) => e.name === name);\n    if (i === -1) return false;\n    this.#entries.splice(i, 1);\n    return true;\n  }\n\n  get size(): number {\n    return this.#entries.length;\n  }\n\n  [Symbol.iterator](): IterableIterator<OutputMetadata> {\n    return this.#entries[Symbol.iterator]();\n  }\n}\n\n/**\n * A deployment output, compiled to a Bicep `output` declaration.\n *\n * @example\n * ```typescript snippet:ignore\n * import { Stack } from \"@azure/provisioning-core\";\n * import { KeyVault } from \"@azure/provisioning-keyvault\";\n *\n * const stack = new Stack(\"my-app\", { targetScope: \"resourceGroup\" });\n * const vault = new KeyVault(stack, {\n *   name: \"kv-my-app\",\n *   location: \"eastus\",\n *   properties: {\n *     tenantId: \"11111111-1111-1111-1111-111111111111\",\n *     sku: { family: \"A\", name: \"standard\" },\n *   },\n * });\n * stack.outputs.add(\"vaultUri\", \"string\", vault.properties.vaultUri);\n * ```\n */\nexport function createOutput<T extends OutputType>(\n  stack: Stack,\n  name: string,\n  type: T,\n  value: OutputValueFor<NoInfer<T>>,\n  options?: OutputOptions,\n): OutputMetadata {\n  return stack.outputs.add(name, type, value, options);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,4BAA2B;AAE3B,kBAAmE;AAuD5D,MAAM,iBAAiB;AAAA,EAC5B,WAA6B,CAAC;AAAA;AAAA,EAG9B,IACE,MACA,MACA,OACA,SACgB;AAChB,2CAAsB,MAAM,mBAAmB;AAC/C,QAAI,KAAK,IAAI,IAAI,GAAG;AAClB,YAAM,IAAI,MAAM,qCAAqC,IAAI,EAAE;AAAA,IAC7D;AACA,SAAK,SAAS,YAAY,SAAS,SAAS,SAAS,eAAW,kCAAW,KAAK,GAAG;AACjF,YAAM,IAAI,MAAM,sBAAsB,IAAI,oBAAoB,IAAI,qBAAqB;AAAA,IACzF;AACA,iDAA4B,OAAO,MAAM,sBAAsB,IAAI,GAAG;AACtE,UAAM,WAA2B,EAAE,MAAM,MAAM,OAAO,GAAG,QAAQ;AACjE,SAAK,SAAS,KAAK,QAAQ;AAC3B,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,MAA0C;AAC5C,WAAO,KAAK,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AAAA,EAClD;AAAA;AAAA,EAGA,OAAkC;AAChC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,MAAuB;AACzB,WAAO,KAAK,IAAI,IAAI,MAAM;AAAA,EAC5B;AAAA;AAAA,EAGA,OAAO,MAAuB;AAC5B,UAAM,IAAI,KAAK,SAAS,UAAU,CAAC,MAAM,EAAE,SAAS,IAAI;AACxD,QAAI,MAAM,GAAI,QAAO;AACrB,SAAK,SAAS,OAAO,GAAG,CAAC;AACzB,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,KAAK,SAAS;AAAA,EACvB;AAAA,EAEA,CAAC,OAAO,QAAQ,IAAsC;AACpD,WAAO,KAAK,SAAS,OAAO,QAAQ,EAAE;AAAA,EACxC;AACF;AAsBO,SAAS,aACd,OACA,MACA,MACA,OACA,SACgB;AAChB,SAAO,MAAM,QAAQ,IAAI,MAAM,MAAM,OAAO,OAAO;AACrD;",
+  "names": []
+}