@azure/provisioning-core 0.1.0-alpha.20261026.1 → 1.0.0-beta.2

package/dist/browser/constructs/resource/resource-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-registry.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-registry.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAoClC,OAAO,EAAE,oBAAoB,EAA4B,MAAM,6BAA6B,CAAC;AAsC7F,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AAMhF,SAAS,WAAW;IAClB,MAAM,IAAI,GAAG,UAAqC,CAAC;IACnD,IAAI,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,GAAG,IAAI,oBAAoB,EAAgB,CAAC;QACpD,IAAI,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,eAAqC;IACxF,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,UAAkB,EAClB,KAA+B,EAC/B,OAAwB;IAExB,OAAO,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,IAAI,EAAE,EAAE;QAC1D,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK;QAChC,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Global registry mapping a resource class's registry key to its\n * constructor.\n *\n * Populated at module load by each class's `static {}` initializer\n * (via {@link Resource.register}). The deserializer reads this\n * registry to construct the correct class instance — preserving\n * identity, prototype methods, and constructor-initialized child\n * collections — instead of materialising a base `Resource`.\n *\n * Each `type@apiVersion` entry is either one flat constructor or a flat list\n * of concrete constructors paired with ordered variant selectors. A selector\n * can contain singleton `name`, model discriminators such as `kind`, and\n * nested discriminator segments.\n *\n * Resolution has two modes:\n *\n * - **Best-effort (default).** Exact `(type, apiVersion)` first, then\n *   falls back to the highest registered `apiVersion` for the same\n *   selector. Enables\n *   deserializing older JSON against a newer package version without\n *   losing typed handles.\n * - **Strict** (opt-in via `{ strict: true }`). Exact match only;\n *   returns `undefined` for any apiVersion the package doesn't ship.\n *\n * The shared registry tracks the highest `apiVersion` per `(type, selector)`.\n * Best-effort lookups consult it in O(1); no scanning is needed.\n *\n * Keyed on a process-global symbol so multiple copies of `@azure/provisioning-core`\n * in the same realm share one registry, mirroring the cross-realm\n * strategy used by {@link isResource}'s brand symbol.\n */\n\nimport type { Resource } from \"./resource.js\";\nimport { ResourceTypeRegistry, type FlatVariantSelector } from \"./resource-type-registry.js\";\n\n/**\n * A `Resource` class that's eligible to live in the registry.\n *\n * - The construct signature uses `any` for both `context` and `props`\n *   because concrete classes narrow these (child resources require a\n *   specific parent class as context; each resource has its own `Props`\n *   shape). TypeScript's parameter contravariance would reject any\n *   concrete parameter types here. The deserializer is the sole caller\n *   of resolved constructors and forwards already-correct values it\n *   built from the wire document.\n * - The two static fields `resourceType` and `apiVersion` form the\n *   registry key and are always present on emitter-generated classes\n *   (and on the hand-maintained `ResourceGroup`).\n * - The generic `T` propagates the instance type — used by the query\n *   API (`stack.getResources(KeyVault)` → `KeyVault[]`) to narrow\n *   return types without needing a separate descriptor object.\n */\nexport type ResourceCtor<T extends Resource = Resource> = {\n  new (context: any, props: any, options?: any): T;\n  readonly resourceType: string;\n  readonly apiVersion: string;\n};\n\n/**\n * Options controlling how {@link resolveResource} handles\n * apiVersion mismatches.\n */\nexport interface ResolveOptions {\n  /**\n   * When `true`, only an exact `(resourceType, apiVersion)` match is\n   * returned; the best-effort fallback to the highest registered\n   * version for the type is skipped. Defaults to `false`.\n   */\n  readonly strict?: boolean;\n}\n\nconst REGISTRY_SYMBOL = Symbol.for(\"@azure/provisioning-core.resourceRegistry\");\n\ninterface RegistryHost {\n  [REGISTRY_SYMBOL]?: ResourceTypeRegistry<ResourceCtor>;\n}\n\nfunction getRegistry(): ResourceTypeRegistry<ResourceCtor> {\n  const host = globalThis as unknown as RegistryHost;\n  let registry = host[REGISTRY_SYMBOL];\n  if (registry === undefined) {\n    registry = new ResourceTypeRegistry<ResourceCtor>();\n    host[REGISTRY_SYMBOL] = registry;\n  }\n  return registry;\n}\n\n/**\n * Register `ctor` as the canonical class for its\n * `(resourceType, apiVersion[, variantSelector])` key.\n *\n * Pass an ordered selector for variants; omit it for ordinary resources.\n * Re-registering the same constructor for the\n * same key is a silent no-op so module-graph re-entry (test\n * harnesses, dual-format builds) is safe. Registering a *different*\n * constructor for an existing key throws — that's a genuine conflict\n * (e.g. two packages claiming the same ARM type).\n *\n * A `(resourceType, apiVersion)` pair is either entirely flat or entirely\n * variant-based. Attempting to mix both modes throws,\n * preserving the invariant the deserializer relies on.\n */\nexport function registerResource(ctor: ResourceCtor, variantSelector?: FlatVariantSelector): void {\n  getRegistry().register(ctor.resourceType, ctor.apiVersion, ctor, variantSelector);\n}\n\n/**\n * Resolve the registered class for a wire resource.\n *\n * Default is best-effort:\n *  1. Try the exact `(type, apiVersion)` entry and match its selectors\n *     against ARM-side keys in `state`.\n *  2. On miss, retry with the highest registered version of each selector.\n *\n * Pass `{ strict: true }` to skip step 2 and require an exact match.\n *\n * Returns `undefined` when nothing matches — callers (notably the\n * deserializer) then fall back to constructing a base `Resource`.\n */\nexport function resolveResource(\n  type: string,\n  apiVersion: string,\n  state?: Record<string, unknown>,\n  options?: ResolveOptions,\n): ResourceCtor | undefined {\n  return getRegistry().resolve(type, apiVersion, state ?? {}, {\n    strict: options?.strict ?? false,\n    valueKeyedBy: \"arm\",\n  });\n}\n"]}

package/dist/browser/constructs/resource/resource-relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-relationships.d.ts","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-relationships.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEtF,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,SAAS,CAO3F;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,GAC5B,mBAAmB,GAAG,SAAS,CAOjC;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAO1F"}

package/dist/{constructs → browser/constructs}/resource/resource-relationships.js

@@ -3,14 +3,12 @@
 import { ResourceGroup } from "../built-in-resources/resource-group.js";
 import { unwrapResourceHandle } from "./resource-proxy.js";
 import { isResourceDeclaration } from "./resource-utils.js";
-import { isExpressionNode, } from "../../expression/ast-nodes.js";
+import { isExpressionNode } from "../../expression/ast-nodes.js";
 /** Finds the nearest resource parent, excluding resource-group containment. */
 export function getArmParent(resource) {
     for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {
         if (isResourceDeclaration(parent)) {
-            return parent.type === ResourceGroup.resourceType
-                ? undefined
-                : parent.self;
+            return parent.type === ResourceGroup.resourceType ? undefined : parent.self;
         }
     }
     return undefined;
@@ -18,8 +16,7 @@ export function getArmParent(resource) {
 /** Finds the resource group containing the authored resource. */
 export function getResourceGroupAncestor(resource) {
     for (let current = resource.parent; current !== undefined; current = current.parent) {
-        if (isResourceDeclaration(current) &&
-            current.type === ResourceGroup.resourceType) {
+        if (isResourceDeclaration(current) && current.type === ResourceGroup.resourceType) {
             return current.self;
         }
     }

package/dist/browser/constructs/resource/resource-relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-relationships.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-relationships.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAuB,MAAM,+BAA+B,CAAC;AAEtF,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,QAA6B;IACxD,KAAK,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAChF,IAAI,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,wBAAwB,CACtC,QAA6B;IAE7B,KAAK,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACpF,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,YAAY,EAAE,CAAC;YAClF,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,QAA6B;IAC5D,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { ResourceGroup } from \"../built-in-resources/resource-group.js\";\nimport { unwrapResourceHandle } from \"./resource-proxy.js\";\nimport { isResourceDeclaration } from \"./resource-utils.js\";\nimport type { ResourceDeclaration } from \"./resource.js\";\nimport { isExpressionNode, type ExpressionNode } from \"../../expression/ast-nodes.js\";\n\n/** Finds the nearest resource parent, excluding resource-group containment. */\nexport function getArmParent(resource: ResourceDeclaration): ResourceDeclaration | undefined {\n  for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {\n    if (isResourceDeclaration(parent)) {\n      return parent.type === ResourceGroup.resourceType ? undefined : parent.self;\n    }\n  }\n  return undefined;\n}\n\n/** Finds the resource group containing the authored resource. */\nexport function getResourceGroupAncestor(\n  resource: ResourceDeclaration,\n): ResourceDeclaration | undefined {\n  for (let current = resource.parent; current !== undefined; current = current.parent) {\n    if (isResourceDeclaration(current) && current.type === ResourceGroup.resourceType) {\n      return current.self;\n    }\n  }\n  return undefined;\n}\n\n/** Reads an explicit scope expression without creating a resource-property reference. */\nexport function getResourceScope(resource: ResourceDeclaration): ExpressionNode | undefined {\n  const scope: unknown = Reflect.get(unwrapResourceHandle(resource), \"scope\");\n  if (scope === undefined) return undefined;\n  if (!isExpressionNode(scope)) {\n    throw new Error(`Invalid authored scope for resource \"${resource.type}\".`);\n  }\n  return scope;\n}\n"]}

package/dist/browser/constructs/resource/resource-type-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-type-registry.d.ts","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-type-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAAG,SAAS,cAAc,EAAE,CAAC;AAE5D,qEAAqE;AACrE,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED,yEAAyE;AACzE,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB;AAED,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,CAAC,CAAC,IACnC;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CACpB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAAE,CAAC;CAClD,CAAC;AAEN,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,IAAI,GAAG,KAAK,CAAC;CACrC;AAOD,2EAA2E;AAC3E,qBAAa,oBAAoB,CAAC,CAAC;;IAIjC,QAAQ,CACN,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,EACT,eAAe,CAAC,EAAE,mBAAmB,GACpC,IAAI;IAYP,OAAO,CACL,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,kCAAkC,GAC1C,CAAC,GAAG,SAAS;CA6DjB;AAgFD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAM5E;AAaD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,OAAO,EAAE,SAAS,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,YAAY,EAAE,IAAI,GAAG,KAAK,GACzB,CAAC,GAAG,SAAS,CASf"}

package/dist/browser/constructs/resource/resource-type-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-type-registry.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-type-registry.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { DiscriminatorNames } from \"../../shape/shape.js\";\n\n/** One discriminator pinned to a fixed value by a concrete flat variant. */\nexport interface FlatVariantPin {\n  readonly discriminator: DiscriminatorNames;\n  readonly value: string;\n}\n\n/** Pins selecting one concrete flat variant. */\nexport type FlatVariantSelector = readonly FlatVariantPin[];\n\n/** One concrete variant together with a selector that chooses it. */\nexport interface FlatVariantSelection<T> {\n  readonly variant: T;\n  readonly selector: FlatVariantSelector;\n}\n\n/** One selector-to-target record stored in a variant registry bucket. */\nexport interface FlatVariantRegistryEntry<T> {\n  readonly selector: FlatVariantSelector;\n  readonly target: T;\n}\n\n/** One `(resourceType, apiVersion)` registry bucket. */\nexport type ResourceTypeRegistryEntry<T> =\n  | {\n      readonly kind: \"flat\";\n      readonly target: T;\n    }\n  | {\n      readonly kind: \"variants\";\n      readonly variants: FlatVariantRegistryEntry<T>[];\n    };\n\nexport interface ResourceTypeRegistryResolveOptions {\n  readonly strict: boolean;\n  readonly valueKeyedBy: \"js\" | \"arm\";\n}\n\ninterface VersionedTarget<T> {\n  readonly apiVersion: string;\n  readonly target: T;\n}\n\n/** Registry for versioned resource-type targets with optional variants. */\nexport class ResourceTypeRegistry<T> {\n  readonly #exact = new Map<string, ResourceTypeRegistryEntry<T>>();\n  readonly #highest = new Map<string, ResourceTypeRegistryEntry<VersionedTarget<T>>>();\n\n  register(\n    resourceType: string,\n    apiVersion: string,\n    target: T,\n    variantSelector?: FlatVariantSelector,\n  ): void {\n    const selector = variantSelector?.length ? variantSelector : undefined;\n    const exactKey = resourceTypeVersionKey(resourceType, apiVersion);\n    const exactEntry = this.#exact.get(exactKey);\n    const highestEntry = this.#highest.get(resourceType);\n\n    assertMode(exactEntry, selector, exactKey);\n    assertMode(highestEntry, selector, resourceType);\n    registerExact(this.#exact, exactKey, target, selector);\n    this.#updateHighest(resourceType, apiVersion, target, selector);\n  }\n\n  resolve(\n    resourceType: string,\n    apiVersion: string,\n    state: Record<string, unknown>,\n    options: ResourceTypeRegistryResolveOptions,\n  ): T | undefined {\n    const exact = resolveEntry(\n      this.#exact.get(resourceTypeVersionKey(resourceType, apiVersion)),\n      state,\n      options.valueKeyedBy,\n    );\n    if (exact !== undefined || options.strict) return exact;\n\n    const fallback = resolveEntry(this.#highest.get(resourceType), state, options.valueKeyedBy);\n    return fallback?.target;\n  }\n\n  #updateHighest(\n    resourceType: string,\n    apiVersion: string,\n    target: T,\n    selector: FlatVariantSelector | undefined,\n  ): void {\n    const entry = this.#highest.get(resourceType);\n    const versionedTarget = { apiVersion, target };\n\n    if (!entry) {\n      this.#highest.set(\n        resourceType,\n        selector\n          ? {\n              kind: \"variants\",\n              variants: [{ selector: [...selector], target: versionedTarget }],\n            }\n          : { kind: \"flat\", target: versionedTarget },\n      );\n      return;\n    }\n\n    if (entry.kind === \"flat\") {\n      if (apiVersionCompare(apiVersion, entry.target.apiVersion) > 0) {\n        this.#highest.set(resourceType, {\n          kind: \"flat\",\n          target: versionedTarget,\n        });\n      }\n      return;\n    }\n\n    const selectorKey = flatVariantSelectorKey(selector!);\n    const priorIndex = entry.variants.findIndex(\n      (variant) => flatVariantSelectorKey(variant.selector) === selectorKey,\n    );\n    const prior = entry.variants[priorIndex];\n    if (!prior) {\n      entry.variants.push({\n        selector: [...selector!],\n        target: versionedTarget,\n      });\n    } else if (apiVersionCompare(apiVersion, prior.target.apiVersion) > 0) {\n      entry.variants[priorIndex] = {\n        selector: [...selector!],\n        target: versionedTarget,\n      };\n    }\n  }\n}\n\nfunction assertMode<T>(\n  entry: ResourceTypeRegistryEntry<T> | undefined,\n  selector: FlatVariantSelector | undefined,\n  key: string,\n): void {\n  if (!entry) return;\n  if (!selector && entry.kind === \"variants\") {\n    throw new Error(`Cannot register flat target for ${key}: variants are already registered.`);\n  }\n  if (selector && entry.kind === \"flat\") {\n    throw new Error(\n      `Cannot register variant target for ${key}: a flat target is already registered.`,\n    );\n  }\n}\n\nfunction registerExact<T>(\n  entries: Map<string, ResourceTypeRegistryEntry<T>>,\n  key: string,\n  target: T,\n  selector: FlatVariantSelector | undefined,\n): void {\n  const entry = entries.get(key);\n  if (!entry) {\n    entries.set(\n      key,\n      selector\n        ? {\n            kind: \"variants\",\n            variants: [{ selector: [...selector], target }],\n          }\n        : { kind: \"flat\", target },\n    );\n    return;\n  }\n\n  if (entry.kind === \"flat\") {\n    if (entry.target !== target) {\n      throw new Error(`Conflicting flat target registration for ${key}.`);\n    }\n    return;\n  }\n\n  const selectorKey = flatVariantSelectorKey(selector!);\n  const existing = entry.variants.find(\n    (variant) => flatVariantSelectorKey(variant.selector) === selectorKey,\n  );\n  if (existing) {\n    if (existing.target !== target) {\n      throw new Error(`Conflicting variant target registration for ${key}@${selectorKey}.`);\n    }\n    return;\n  }\n  entry.variants.push({ selector: [...selector!], target });\n}\n\nfunction resolveEntry<T>(\n  entry: ResourceTypeRegistryEntry<T> | undefined,\n  state: Record<string, unknown>,\n  valueKeyedBy: \"js\" | \"arm\",\n): T | undefined {\n  if (!entry) return undefined;\n  if (entry.kind === \"flat\") return entry.target;\n  return resolveFlatVariant(entry.variants, state, valueKeyedBy);\n}\n\nfunction resourceTypeVersionKey(resourceType: string, apiVersion: string): string {\n  return `${resourceType}@${apiVersion}`;\n}\n\n/** Compare ARM API versions for best-effort fallback selection. */\nfunction apiVersionCompare(left: string, right: string): number {\n  if (left === right) return 0;\n  if (right.startsWith(`${left}-`)) return 1;\n  if (left.startsWith(`${right}-`)) return -1;\n  return left < right ? -1 : 1;\n}\n\n/**\n * Stable identity for duplicate detection and version indexes.\n * Pins are sorted in the key because the matched state is flat and selector\n * matching is a conjunction of discriminator/value pairs, independent of\n * hierarchy order. The selector itself is not mutated.\n */\nexport function flatVariantSelectorKey(selector: FlatVariantSelector): string {\n  const pins = selector.map(\n    ({ discriminator, value }) => [discriminator.jsName, discriminator.armName, value] as const,\n  );\n  pins.sort(comparePinTuples);\n  return JSON.stringify(pins);\n}\n\nfunction comparePinTuples(\n  left: readonly [string, string, string],\n  right: readonly [string, string, string],\n): number {\n  for (let index = 0; index < left.length; index++) {\n    if (left[index]! < right[index]!) return -1;\n    if (left[index]! > right[index]!) return 1;\n  }\n  return 0;\n}\n\n/** Resolve the first registered selector exactly matched by `state`. */\nexport function resolveFlatVariant<T>(\n  entries: readonly FlatVariantRegistryEntry<T>[],\n  state: Record<string, unknown> | undefined,\n  valueKeyedBy: \"js\" | \"arm\",\n): T | undefined {\n  if (!state) return undefined;\n\n  for (const entry of entries) {\n    if (matchesSelector(entry.selector, state, valueKeyedBy)) {\n      return entry.target;\n    }\n  }\n  return undefined;\n}\n\nfunction matchesSelector(\n  selector: FlatVariantSelector,\n  state: Record<string, unknown>,\n  valueKeyedBy: \"js\" | \"arm\",\n): boolean {\n  return selector.every(({ discriminator, value }) => {\n    const key = valueKeyedBy === \"js\" ? discriminator.jsName : discriminator.armName;\n    return state[key] === value;\n  });\n}\n"]}

package/dist/browser/constructs/resource/resource-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-utils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AAEH,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,QAAQ,CAIpD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAM1E;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,CAM1E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAE1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,QAAQ,EACnD,CAAC,EAAE,OAAO,EACV,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GACpB,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAExB"}

package/dist/{constructs → browser/constructs}/resource/resource-utils.js

@@ -18,9 +18,7 @@ import { RESOURCE_BRAND, RESOURCE_DECLARATION_BRAND, LOOPED_RESOURCE_BRAND, } fr
  */
 /** Is `x` a scalar {@link Resource} (not a looped declaration)? */
 export function isResource(x) {
-    return (typeof x === "object" &&
-        x !== null &&
-        x[RESOURCE_BRAND] === true);
+    return (typeof x === "object" && x !== null && x[RESOURCE_BRAND] === true);
 }
 /**
  * Is `x` a Bicep resource declaration — either a scalar {@link Resource} or

package/dist/browser/constructs/resource/resource-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAI7B;;;;;;;;;;;;;;GAcG;AAEH,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,CAAU;IACnC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAK,CAA6B,CAAC,cAAc,CAAC,KAAK,IAAI,CAC/F,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACT,CAA6B,CAAC,0BAA0B,CAAC,KAAK,IAAI,CACpE,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACT,CAA6B,CAAC,qBAAqB,CAAC,KAAK,IAAI,CAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAAqB,CAAU,EAAE,IAAqB;IAChF,OAAO,CAAC,YAAY,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,CAAU,EACV,IAAqB;IAErB,OAAO,gBAAgB,CAAC,CAAC,CAAC,IAAK,CAAC,CAAC,WAAuB,KAAK,IAAI,CAAC;AACpE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  RESOURCE_BRAND,\n  RESOURCE_DECLARATION_BRAND,\n  LOOPED_RESOURCE_BRAND,\n} from \"./resource-proxy.js\";\nimport type { Resource, ResourceDeclaration, LoopedResource } from \"./resource.js\";\nimport type { ResourceCtor } from \"./resource-registry.js\";\n\n/**\n * Cross-realm-safe brand guards for resource declarations.\n *\n * These live in a standalone module — importing only the brand **symbols**\n * (from `resource-proxy.ts`) and `resource.ts` **types** — so tree-walking\n * utilities (e.g. the query layer, `ProvisioningComponent`) can identify resources\n * WITHOUT a runtime import of `resource.ts`, which `extends ProvisioningComponent` and\n * would otherwise create an eval-time import cycle\n * (`ProvisioningComponent` → `query` → `resource` → `ProvisioningComponent`).\n *\n * The public guard API is these standalone functions (`isResource`,\n * `isResourceDeclaration`, `isLoopedResource`, `isResourceOf`,\n * `isLoopedResourceOf`) — there are no class-static guards, so a subclass\n * like `Secret` never inherits a misleading `Secret.isResource(...)`.\n */\n\n/** Is `x` a scalar {@link Resource} (not a looped declaration)? */\nexport function isResource(x: unknown): x is Resource {\n  return (\n    typeof x === \"object\" && x !== null && (x as Record<symbol, unknown>)[RESOURCE_BRAND] === true\n  );\n}\n\n/**\n * Is `x` a Bicep resource declaration — either a scalar {@link Resource} or\n * a {@link LoopedResource}?\n */\nexport function isResourceDeclaration(x: unknown): x is ResourceDeclaration {\n  return (\n    typeof x === \"object\" &&\n    x !== null &&\n    (x as Record<symbol, unknown>)[RESOURCE_DECLARATION_BRAND] === true\n  );\n}\n\n/** Is `x` a {@link LoopedResource} (`Ctor.fromLoop(...)`)? */\nexport function isLoopedResource(x: unknown): x is LoopedResource<Resource> {\n  return (\n    typeof x === \"object\" &&\n    x !== null &&\n    (x as Record<symbol, unknown>)[LOOPED_RESOURCE_BRAND] === true\n  );\n}\n\n/**\n * Type guard: is `x` an instance of the resource class `ctor`?\n * Narrows `x` to the class's instance type, so callers can access\n * subclass-specific accessors (e.g. `kv.secrets`) inside the guarded\n * block.\n *\n * Accepts any value (`unknown`), like the other brand guards. A\n * `LoopedResource<T>` is not a `Resource`, so `instanceof ctor` returns\n * `false` for it — the narrowing is safe. `instanceof` alone is sufficient\n * (and stricter than a brand + ARM-type-string check: a base-`Resource`\n * impostor carrying the same `type`/`apiVersion` is correctly rejected), so\n * no `isResource` pre-check is needed.\n *\n * Matches scalar resource **declarations** (from a constructor / query /\n * collection). It does NOT match a `parent.at(i)` element reference of a\n * looped declaration: that proxy intentionally keeps `LoopedResource`'s\n * prototype (no `getPrototypeOf` trap), so `instanceof` is `false` for it\n * even though its ARM reads work. If we ever need cross-realm subclass\n * matching (per-subclass `Symbol.for` brands, mirroring the base\n * `RESOURCE_BRAND`), this is the one place to swap.\n */\nexport function isResourceOf<T extends Resource>(x: unknown, ctor: ResourceCtor<T>): x is T {\n  return x instanceof ctor;\n}\n\n/**\n * Type guard: is `x` a {@link LoopedResource} whose wrapped resource class is\n * `ctor` (i.e. a `LoopedResource<T>` produced by `T.fromLoop(...)`)? Narrows\n * `x` to `LoopedResource<T>`, the looped analogue of {@link isResourceOf}.\n *\n * Matches on the declaration's `wrappedCtor` identity — the concrete subclass\n * passed to `fromLoop` — so `isLoopedResourceOf(x, StorageAccount)`\n * replaces the `x.wrappedCtor === StorageAccount` checks scattered across the\n * query / collection layers.\n */\nexport function isLoopedResourceOf<T extends Resource>(\n  x: unknown,\n  ctor: ResourceCtor<T>,\n): x is LoopedResource<T> {\n  return isLoopedResource(x) && (x.wrappedCtor as unknown) === ctor;\n}\n"]}

package/dist/browser/constructs/resource/resource.d.ts.map

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

package/dist/{constructs → browser/constructs}/resource/resource.js

@@ -4,10 +4,10 @@ import { ProvisioningComponent } from "../provisioning-component.js";
 import { createBinaryExpression, unwrapExpression, wrapExpression, } from "../../expression/expressions.js";
 import { symbolicValueExpressionNode } from "../../expression/ast-nodes.js";
 import { assertValidResourceName } from "../../naming/name-validation.js";
-import { namingRequiredPolicy, generateResourceName, } from "../../naming/naming-policy.js";
+import { namingRequiredPolicy, generateResourceName } from "../../naming/naming-policy.js";
 import { RAW_RESOURCE_HANDLE, RESOURCE_BRAND, RESOURCE_DECLARATION_BRAND, LOOPED_RESOURCE_BRAND, PROXY_INDEX_REF, INDEXED_PROXY_TARGET, STATE_PARENT_INDEX, createIndexedResourceProxy, createResourceMemberProxy, createResourceProxy, normalizeAssignedValue, unwrapResourceHandle, } from "./resource-proxy.js";
 import { isResourceDeclaration } from "./resource-utils.js";
-import { getShape, registerShape as registerShapeInRegistry, } from "../../shape/shape-registry.js";
+import { getShape, registerShape as registerShapeInRegistry } from "../../shape/shape-registry.js";
 import { registerResource as registerResourceInRegistry, } from "./resource-registry.js";
 /**
  * Shared base for resource declaration implementations.
@@ -71,8 +71,7 @@ export class ResourceDeclaration extends ProvisioningComponent {
         // Automatic naming uses the authored rather than the discovered hierarchy.
         const nameSegments = namingRules !== undefined &&
             (armParent !== undefined || namingRules.nameSegments !== undefined)
-            ? props.type.split("/").length -
-                (armParent?.type.split("/").length ?? 1)
+            ? props.type.split("/").length - (armParent?.type.split("/").length ?? 1)
             : undefined;
         if (props.name !== undefined) {
             assertValidResourceName(props.name, props.type, namingRules);
@@ -118,9 +117,7 @@ export class ResourceDeclaration extends ProvisioningComponent {
         while (parent !== undefined && !isResourceDeclaration(parent)) {
             parent = parent.parent;
         }
-        const inheritedCondition = isResourceDeclaration(parent)
-            ? parent.condition
-            : undefined;
+        const inheritedCondition = isResourceDeclaration(parent) ? parent.condition : undefined;
         const explicitCondition = options?.condition;
         const condition = explicitCondition !== undefined && inheritedCondition !== undefined
             ? createBinaryExpression("&&", inheritedCondition, explicitCondition)
@@ -191,8 +188,7 @@ export class ResourceDeclaration extends ProvisioningComponent {
             const shape = getShape(props.type, props.apiVersion, data);
             if (shape !== undefined) {
                 const properties = Object.entries(shape.byJsName);
-                const locationProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 &&
-                    (property.armPath[0] ?? jsName) === "location");
+                const locationProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === "location");
                 const locationName = locationProperty?.[0];
                 const locationShape = locationProperty?.[1];
                 if (locationName !== undefined &&
@@ -202,8 +198,7 @@ export class ResourceDeclaration extends ProvisioningComponent {
                     ctx.location !== undefined) {
                     data[locationName] = ctx.location;
                 }
-                const tagsProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 &&
-                    (property.armPath[0] ?? jsName) === "tags");
+                const tagsProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === "tags");
                 const tagsName = tagsProperty?.[0];
                 const tagsShape = tagsProperty?.[1];
                 if (tagsName !== undefined &&
@@ -569,7 +564,8 @@ export class LoopedResource extends ResourceDeclaration {
         if (props.name === undefined) {
             throw new Error(`Looped resource '${props.type}' requires an explicit per-iteration name.`);
         }
-        const namingRules = wrappedCtor.namingRules;
+        const namingRules = wrappedCtor
+            .namingRules;
         wrappedCtor.validate.call(wrappedCtor, context, props, options, namingRules);
         super(context, props, options, namingRules);
         this.#wrappedCtor = wrappedCtor;

package/dist/browser/constructs/resource/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { ProvisioningComponent } from \"../provisioning-component.js\";\nimport {\n  createBinaryExpression,\n  unwrapExpression,\n  wrapExpression,\n  type Expression,\n  type ExpressionOrValue,\n} from \"../../expression/expressions.js\";\nimport type { ExpressionNode } from \"../../expression/ast-nodes.js\";\nimport { symbolicValueExpressionNode } from \"../../expression/ast-nodes.js\";\nimport type { PropertySegment } from \"../../types.js\";\nimport type { ResourceNamingRules } from \"../../naming/naming-rules.js\";\nimport { assertValidResourceName } from \"../../naming/name-validation.js\";\nimport { namingRequiredPolicy, generateResourceName } from \"../../naming/naming-policy.js\";\nimport {\n  RAW_RESOURCE_HANDLE,\n  RESOURCE_BRAND,\n  RESOURCE_DECLARATION_BRAND,\n  LOOPED_RESOURCE_BRAND,\n  PROXY_INDEX_REF,\n  INDEXED_PROXY_TARGET,\n  STATE_PARENT_INDEX,\n  createIndexedResourceProxy,\n  createResourceMemberProxy,\n  createResourceProxy,\n  normalizeAssignedValue,\n  unwrapResourceHandle,\n} from \"./resource-proxy.js\";\nimport { isResourceDeclaration } from \"./resource-utils.js\";\nimport type { FlatModelShape } from \"../../shape/shape.js\";\nimport { getShape, registerShape as registerShapeInRegistry } from \"../../shape/shape-registry.js\";\nimport {\n  registerResource as registerResourceInRegistry,\n  type ResourceCtor,\n} from \"./resource-registry.js\";\nimport type { FlatVariantSelector } from \"./resource-type-registry.js\";\n\n// ---------------------------------------------------------------------------\n// Resource types\n// ---------------------------------------------------------------------------\n\n/**\n * A Bicep `scope:` expression. Used on `existing` resource references for\n * cross-RG / cross-subscription / cross-MG / cross-tenant lookups, and on\n * modules to set the nested deployment scope.\n *\n * Typed as `Expression<unknown>` because the natural producers are the\n * scope-function helpers in `fn` (`fn.resourceGroup(...)`,\n * `fn.subscription(...)`, `fn.managementGroup(...)`, `fn.tenant()`), all\n * of which return `Expression<TScope>` proxies. Narrowing further isn't\n * worthwhile today since the set of acceptable scope-producing\n * expressions isn't closed and Bicep validates the actual call shape\n * downstream.\n */\n// TODO: further narrow to allowed expression if possible?\nexport type ScopeExpression = Expression<unknown>;\n\n/**\n * Internal representation used to construct resource handle objects.\n * The proxy converts these into the public Resource shape.\n */\nexport interface ResourceState<TType extends string = string> {\n  name: ExpressionOrValue<string>;\n  readonly type: TType;\n  readonly apiVersion: string;\n  readonly existing?: boolean | undefined;\n  /**\n   * Explicit scope expression. Authoring populates this for existing-resource\n   * lookups; restoration can retain uninterpreted scope expressions on any\n   * declaration. Expressions are normalized to raw nodes.\n   *\n   * New-resource authoring still derives placement from the Stack and parent\n   * context rather than accepting an explicit scope override.\n   */\n  readonly scope?: ExpressionNode | undefined;\n  readonly condition?: ExpressionOrValue<boolean> | undefined;\n}\n\n/**\n * Public-facing props for a reference to an existing (pre-deployed) Azure\n * resource. This is strictly narrower than the deployable resource props —\n * Bicep `existing` declarations only accept `name` and optional `scope:`.\n *\n * Read-side access on the returned resource handle is unrestricted —\n * `kv.properties.vaultUri`, `sa.id`, etc. all work and compile to symbolic\n * references that ARM resolves at deployment time.\n *\n * Symbolic parent/extension scopes are expressed by passing the parent\n * resource as the ProvisioningComponent `context` argument to the resource constructor\n * (with `{ existing: true }`), not via this `scope` field.\n */\nexport interface ExistingResourceProps<TName extends string = string> {\n  /** Required. The actual Azure name of the existing resource. */\n  readonly name: ExpressionOrValue<TName>;\n\n  /**\n   * Optional. The scope at which to look up the resource. Used when the\n   * resource lives outside the current deployment's scope (different RG,\n   * subscription, management group, or tenant).\n   *\n   * Pass a scope-function call expression (e.g. `resourceGroup(\"name\")`,\n   * `subscription()`, `managementGroup(\"mg\")`, `tenant()`).\n   */\n  readonly scope?: ScopeExpression;\n}\n\n/**\n * `ExistingResourceProps` for singleton child resources — `name` is omitted\n * because singleton children have a fixed name (e.g. `\"default\"`).\n */\nexport type SingletonExistingResourceProps = Omit<ExistingResourceProps, \"name\">;\n\n/**\n * Internal props accepted by the base `Resource` constructor. A loose\n * superset of both the deployable and existing public shapes — the runtime\n * constructor branches on `props.existing` to decide which fields are\n * honored. Generated CDK resource classes expose a discriminated union\n * `(Deployable & { existing?: false }) | (Existing & { existing: true })`;\n * passing `{ ...existingProps, existing: true }` selects the existing arm and\n * emits a Bicep `existing` reference instead of a new declaration.\n */\nexport interface ResourceProps<TType extends string> {\n  readonly name?: ExpressionOrValue<string> | undefined;\n  readonly apiVersion: string;\n  readonly type: TType;\n\n  readonly existing?: boolean;\n\n  /**\n   * Optional Bicep `scope:` value for an existing resource reference.\n   * Only honored when `existing === true`. Ignored on deployable resources\n   * (non-existing resources have no per-resource scope in Bicep).\n   */\n  readonly scope?: ScopeExpression;\n}\n\n/**\n * Optional third-argument bag passed to every resource constructor. Holds\n * authoring flags that affect how the resource declaration is emitted but are\n * not ARM-modeled properties of the resource body.\n *\n * Fields:\n * - `condition` — an `if(...)` guard on the declaration. A boolean\n *   expression (typically produced by `fn.eq`, `fn.and`, etc.) or a\n *   plain `boolean`. Bind it to a `const` to reuse the same predicate\n *   across multiple resources.\n *\n * `existing` is deliberately **not** an option — it is the discriminant of\n * the generated props union (`{ existing?: false } | { existing: true }`)\n * and lives on `props`. Routing it through options too would allow\n * contradictory settings between the two channels.\n *\n * `namingRules` is deliberately **not** an option either — it is\n * per-resource-type metadata declared as a `protected static namingRules`\n * field on each concrete `Resource` subclass and consumed by the base\n * constructor reflectively, so it stays off the user-facing surface.\n *\n */\nexport interface ResourceOptions {\n  readonly condition?: ExpressionOrValue<boolean>;\n  readonly dependsOn?: readonly ResourceDeclaration[];\n}\n\n/**\n * Shared base for resource declaration implementations.\n *\n * @remarks\n *\n * Both represent one Bicep resource declaration in the component tree and\n * share the same declaration-level state layout: identity fields\n * (`type`, `apiVersion`, `existing`), the `if(...)` guard (`condition`),\n * the optional cross-scope reference (`scope`), and the raw prop bag that\n * becomes the resource body.\n *\n * This class owns the common declaration state layout, raw-handle escape\n * hatch, and identity accessors. Subclasses supply their construction and\n * access behavior.\n */\nexport abstract class ResourceDeclaration<\n  TType extends string = string,\n> extends ProvisioningComponent {\n  protected readonly namingRules: ResourceNamingRules | undefined;\n  /**\n   * Brand marker for cross-realm `isResourceDeclaration()` checks. Uses\n   * `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.\n   * Inherited by every resource declaration implementation.\n   */\n  readonly [RESOURCE_DECLARATION_BRAND] = true as const;\n\n  // Not `readonly`: the ctor writes `this.state = data` once. TypeScript\n  // forbids subclass writes to a `readonly` parent field, so the\n  // immutability is a runtime contract (never reassigned after ctor)\n  // rather than a static one.\n  protected state!: ResourceState<TType> & Record<string, unknown>;\n\n  /**\n   * Base constructor for every Bicep resource declaration.\n   *\n   * @remarks\n   *\n   * Responsibilities:\n   * 1. Register in the component tree (`super(context)`).\n   * 2. Enforce a deployment context ancestor.\n   * 3. Unwrap `context` if it's an indexed proxy from `.at(i)` /\n   *    `parent.at(loop.index)`, and stash `parentIndex` on `state` so the\n   *    serializer can emit `parent: parentSym[index]` on the child.\n   * 4. Inherit `condition` from the immediate parent resource\n   *    declaration when the caller doesn't supply one (Bicep requires\n   *    children of a conditional resource to share the same guard).\n   * 5. Populate `state` — existing arm records only identity fields;\n   *    deployable arm runs the naming policy and applies\n   *    `DeploymentContext` defaults for `location` / `tags` per the\n   *    shape descriptor.\n   *\n   * Subclasses supply the last mile, including their public handle behavior.\n   *\n   * @param namingRules - per-resource-type constraints for the naming\n   *   policy. `Resource` reads this reflectively off the concrete subclass\n   *   constructor; internal declaration implementations receive it from\n   *   the concrete resource constructor they represent.\n   */\n  constructor(\n    context: ProvisioningComponent,\n    props: ResourceProps<TType> & Record<string, unknown>,\n    options?: ResourceOptions,\n    namingRules?: ResourceNamingRules,\n  ) {\n    const armParent =\n      isResourceDeclaration(context) &&\n      props.type.toLowerCase().startsWith(context.type.toLowerCase() + \"/\")\n        ? context\n        : undefined;\n    // Automatic naming uses the authored rather than the discovered hierarchy.\n    const nameSegments =\n      namingRules !== undefined &&\n      (armParent !== undefined || namingRules.nameSegments !== undefined)\n        ? props.type.split(\"/\").length - (armParent?.type.split(\"/\").length ?? 1)\n        : undefined;\n    if (props.name !== undefined) {\n      assertValidResourceName(props.name, props.type, namingRules);\n    }\n    super(context);\n    this.namingRules = namingRules;\n\n    if (!this.hasDeploymentContext()) {\n      throw new Error(\"Resource declaration must have a parent deployment context.\");\n    }\n\n    // If `context` is an indexed proxy returned by\n    // `LoopedResource.at(i)`, unwrap `this.parent`\n    // back to the raw parent so tree walks and symbol-map lookups continue\n    // to work, and capture the index so the serializer can emit\n    // `parent: parentSym[index]` on this child. The `ProvisioningComponent` constructor\n    // already pushed `this` into the correct children array (indexed proxy\n    // passes `.children` through to the raw parent's array), so nothing to\n    // fix up there.\n    //\n    // The index is recorded on the child's state (not the parent's) because\n    // siblings can have different indices — `new Child(p.at(0), …)` and\n    // `new Child(p.at(1), …)` both resolve `.parent` to the same raw parent,\n    // so the index that distinguishes them must be per-child.\n    const indexRef = (context as unknown as Record<symbol, unknown>)[PROXY_INDEX_REF];\n    let parentIndex: unknown = undefined;\n    if (indexRef !== undefined) {\n      const rawParent = (context as unknown as Record<symbol, unknown>)[INDEXED_PROXY_TARGET] as\n        ProvisioningComponent | undefined;\n      if (rawParent !== undefined) {\n        (this as unknown as { parent: ProvisioningComponent | undefined }).parent = rawParent;\n      }\n      parentIndex = indexRef;\n    }\n\n    // `existing` lives on `props` (it's the discriminant of the generated\n    // `{ existing?: false } | { existing: true }` union). `condition` is\n    // routed through `options`.\n    //\n    // Bicep requires a child of a conditional resource to itself be\n    // conditional on the same expression. When no explicit `condition` is\n    // supplied, inherit the nearest parent resource declaration's\n    // condition so the emitted template stays valid — child authoring\n    // shouldn't have to redundantly restate the parent's guard.\n    const isExisting = props.existing === true;\n    let parent = this.parent;\n    while (parent !== undefined && !isResourceDeclaration(parent)) {\n      parent = parent.parent;\n    }\n    const inheritedCondition = isResourceDeclaration(parent) ? parent.condition : undefined;\n    const explicitCondition = options?.condition;\n    const condition =\n      explicitCondition !== undefined && inheritedCondition !== undefined\n        ? createBinaryExpression<boolean>(\"&&\", inheritedCondition, explicitCondition)\n        : (explicitCondition ?? inheritedCondition);\n    const dependsOn = options?.dependsOn;\n\n    let data: ResourceState<TType> & Record<string, unknown>;\n    if (isExisting) {\n      // Existing arm: only name + optional scope land in state. Any other\n      // keys on the props object are ignored — the deserialize path may pass\n      // them through, but they're never emitted on an `existing` resource.\n      if (props.name === undefined) {\n        throw new Error(`Resource ${props.type} marked as 'existing' but no 'name' was provided.`);\n      }\n      data = {\n        name: props.name,\n        type: props.type,\n        apiVersion: props.apiVersion,\n        existing: true,\n        scope: props.scope === undefined ? undefined : unwrapExpression(props.scope),\n        condition,\n        dependsOn,\n      };\n      if (parentIndex !== undefined) {\n        data[STATE_PARENT_INDEX] = parentIndex;\n      }\n    } else {\n      // Deployable arm: name flows through the naming policy; the keys\n      // handled explicitly here are stripped from the props bag, and\n      // every remaining key is copied verbatim into state as a user-\n      // authored property.\n      const {\n        name: _name,\n        type: _type,\n        apiVersion: _apiVersion,\n        existing: _existing,\n        scope: _scope,\n        ...userProps\n      } = props as ResourceProps<TType> & Record<string, unknown>;\n      const ctx = this.deploymentContext;\n      let resolvedName: ExpressionOrValue<string>;\n      try {\n        resolvedName =\n          props.name ??\n          generateResourceName(\n            ctx.namingPolicy ?? namingRequiredPolicy,\n            props.type,\n            namingRules,\n            nameSegments,\n          );\n      } catch (error) {\n        // A rejected generated name must not leave a partial declaration\n        // registered in its parent's tree.\n        const index = this.parent?.children.indexOf(this) ?? -1;\n        if (index >= 0) this.parent!.children.splice(index, 1);\n        throw error;\n      }\n      data = {\n        name: resolvedName,\n        type: props.type,\n        apiVersion: props.apiVersion,\n        condition,\n        dependsOn,\n        ...userProps,\n      };\n\n      if (parentIndex !== undefined) {\n        data[STATE_PARENT_INDEX] = parentIndex;\n      }\n\n      // Apply DeploymentContext defaults for `location` and `tags`, gated\n      // on the shape descriptor declaring those properties as writable.\n      // The TypeSpec model is the source of truth: a field marked\n      // readonly in the ARM contract (e.g. `location` on most child\n      // resources) is server-set, so propagating an inherited value\n      // would produce an invalid PUT body. Both fields are user-wins:\n      // if the user supplied a value, the inherited value is ignored\n      // entirely (no merge for tags either — explicit user tags fully\n      // replace inherited tags).\n      const shape = getShape(props.type, props.apiVersion, data);\n      if (shape !== undefined) {\n        const properties = Object.entries(shape.byJsName);\n        const locationProperty = properties.find(\n          ([jsName, property]) =>\n            property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === \"location\",\n        );\n        const locationName = locationProperty?.[0];\n        const locationShape = locationProperty?.[1];\n        if (\n          locationName !== undefined &&\n          locationShape !== undefined &&\n          locationShape.readOnly !== true &&\n          data[locationName] === undefined &&\n          ctx.location !== undefined\n        ) {\n          data[locationName] = ctx.location;\n        }\n        const tagsProperty = properties.find(\n          ([jsName, property]) =>\n            property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === \"tags\",\n        );\n        const tagsName = tagsProperty?.[0];\n        const tagsShape = tagsProperty?.[1];\n        if (\n          tagsName !== undefined &&\n          tagsShape !== undefined &&\n          tagsShape.readOnly !== true &&\n          data[tagsName] === undefined &&\n          ctx.tags !== undefined &&\n          Object.keys(ctx.tags).length > 0\n        ) {\n          data[tagsName] = { ...ctx.tags };\n        }\n      }\n    }\n\n    this.state = data;\n  }\n\n  /**\n   * Core-internal escape hatch: exposes the raw `state` backing object to\n   * the proxy layer (`resource-proxy.ts`) so it can read/unwrap the\n   * declaration's data across module boundaries. Keyed by the\n   * module-scoped {@link RAW_RESOURCE_HANDLE} symbol, which is **not**\n   * exported from `@azure/provisioning-core`, so package consumers can't name it.\n   *\n   * `protected` (not `private`) because the accessors that read it use\n   * `Reflect.get` / structural casts that bypass TS visibility anyway;\n   * the modifier just keeps it off the public type surface. It can't be a\n   * `#private` field because the proxy layer lives in a different class.\n   *\n   * @internal\n   */\n  protected get [RAW_RESOURCE_HANDLE](): ResourceState<TType> & Record<string, unknown> {\n    return this.state;\n  }\n\n  get type(): TType {\n    return this.state.type;\n  }\n\n  get apiVersion(): string {\n    return this.state.apiVersion;\n  }\n\n  get existing(): boolean | undefined {\n    return this.state.existing;\n  }\n\n  get condition(): ExpressionOrValue<boolean> | undefined {\n    return this.state.condition;\n  }\n\n  get dependsOn(): readonly ResourceDeclaration[] | undefined {\n    return this.state.dependsOn as readonly ResourceDeclaration[] | undefined;\n  }\n\n  protected expr<TValue>(...path: readonly PropertySegment[]): Expression<TValue> & TValue {\n    return createResourceMemberProxy(\n      {\n        resource: this as unknown as Resource,\n        root: unwrapResourceHandle(this as unknown as Resource) as unknown as Record<\n          string,\n          unknown\n        >,\n      },\n      path,\n    );\n  }\n\n  protected setProperty(key: string, value: unknown): void {\n    if (key === \"name\") {\n      assertValidResourceName(value, this.type, this.namingRules);\n    }\n    this.state[key] = normalizeAssignedValue(value, this as unknown as Resource);\n  }\n}\n\n/**\n * Base class for all Azure resources.\n *\n * @remarks\n * Resources are fully initialized at construction time. Pass a parent\n * `ProvisioningComponent` (typically a `Stack` or `ResourceGroup`) as the first\n * argument — the resource registers itself in the tree automatically.\n *\n * Properties use expression-backed proxies: reading `resource.name`\n * returns an `Expression` that compiles to a Bicep symbolic reference,\n * not a plain string. Use `this.expr()` in subclasses to create\n * property getters and `this.setProperty()` for setters.\n *\n * @example\n * ```typescript snippet:ignore\n * import { ResourceGroup, Stack } from \"@azure/provisioning-core\";\n * import { KeyVault } from \"@azure/provisioning-keyvault\";\n *\n * const stack = new Stack(\"my-app\", { targetScope: \"subscription\" });\n * const rg = new ResourceGroup(stack, { name: \"rg-my-app\", location: \"eastus\" });\n * const vault = new KeyVault(rg, {\n *   name: \"kv-my-app\",\n *   properties: {\n *     tenantId: \"11111111-1111-1111-1111-111111111111\",\n *     sku: { family: \"A\", name: \"standard\" },\n *   },\n * });\n *\n * // vault.name is an Expression, not a string\n * // vault.id compiles to resourceId(...)\n * ```\n */\nexport class Resource<TType extends string = string> extends ResourceDeclaration<TType> {\n  /**\n   * Brand marker for cross-realm `isResource()` checks.\n   * Uses `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.\n   */\n  readonly [RESOURCE_BRAND] = true as const;\n\n  /**\n   * Register a {@link FlatModelShape} for this resource class's\n   * `(resourceType, apiVersion)` pair. Intended to be invoked from a\n   * `static {}` initializer in generated subclasses so the registration\n   * happens at module load.\n   *\n   * The static method reads `resourceType` and `apiVersion` off `this`\n   * (the subclass that called it), so callers don't repeat the literals.\n   */\n  static registerShape(\n    this: { readonly resourceType: string; readonly apiVersion: string },\n    shape: FlatModelShape,\n    variantSelector?: FlatVariantSelector,\n  ): void {\n    registerShapeInRegistry(this.resourceType, this.apiVersion, shape, variantSelector);\n  }\n\n  /**\n   * Register this class with the global resource registry so the\n   * deserializer can reconstruct instances of it (instead of falling\n   * back to base `Resource`) for matching `(resourceType, apiVersion)`\n   * pairs. Intended to be invoked from a `static {}` initializer in\n   * generated classes alongside {@link Resource.registerShape}.\n   *\n   * Pass an ordered discriminator path for concrete resource variants. A\n   * singleton is one segment (`name=signin`); model-discriminated resources\n   * may use `kind` or several nested segments. Omit for ordinary resources.\n   */\n  protected static register(this: ResourceCtor, variantSelector?: FlatVariantSelector): void {\n    registerResourceInRegistry(this, variantSelector);\n  }\n\n  /**\n   * Assemble the base-`Resource` constructor payload (the second `super(...)`\n   * argument) from the user-facing props. This is a **static \"virtual\"**:\n   * it runs before an instance exists (to compute the `super` argument), so\n   * it can't be an instance method — but it still dispatches through the\n   * calling constructor, so a subclass's override wins.\n   *\n   * Every emitter-generated resource overrides this to inject its fixed\n   * identity (`type` / `apiVersion`), the singleton `name`, and its explicit\n   * writable-field copy. Both ordinary construction and internal resource\n   * reconstruction funnel through this method so prop shaping remains\n   * consistent.\n   *\n   * This base default is the fallback used when the wrapped constructor is\n   * base `Resource` itself — the deserialize path for an unregistered\n   * `(type, apiVersion)` pair, where `type` / `apiVersion` are threaded in\n   * through `props` rather than read off statics. Keeping the default here\n   * guarantees the method is always present for internal reconstruction.\n   */\n  protected static buildResourceProps(\n    props?: unknown,\n  ): ResourceProps<string> & Record<string, unknown> {\n    const p = (props as Record<string, unknown> | undefined) ?? {};\n    return {\n      ...p,\n      type:\n        (p[\"type\"] as string | undefined) ??\n        (this as unknown as { resourceType?: string }).resourceType,\n      apiVersion:\n        (p[\"apiVersion\"] as string | undefined) ??\n        (this as unknown as { apiVersion?: string }).apiVersion,\n    } as ResourceProps<string> & Record<string, unknown>;\n  }\n\n  /**\n   * Per-resource-type naming constraints, consumed by the active\n   * {@link NamingPolicy} when a resource is created without an explicit\n   * `name`. Generated CDK subclasses override this with a concrete value;\n   * the base default of `undefined` uses the default naming convention.\n   *\n   * This is type metadata, not user input, so it is kept off the public\n   * props surface and read reflectively in the constructor via\n   * `this.constructor` rather than being threaded through `ResourceProps`.\n   */\n  protected static namingRules?: ResourceNamingRules;\n\n  /** Validates construction inputs before a scalar or looped declaration is registered. */\n  protected static validate(\n    _context: ProvisioningComponent,\n    _props: ResourceProps<string> & Record<string, unknown>,\n    _options?: ResourceOptions,\n    _namingRules?: ResourceNamingRules,\n  ): void {\n    // Resource subclasses can impose additional construction constraints.\n  }\n\n  protected _selfProxy: this | undefined;\n\n  constructor(\n    context: ProvisioningComponent,\n    props: ResourceProps<TType> & Record<string, unknown>,\n    options?: ResourceOptions,\n  ) {\n    const namingRules = (new.target as typeof Resource).namingRules;\n    (new.target as typeof Resource).validate(context, props, options, namingRules);\n    super(context, props, options, namingRules);\n\n    const proxy = createResourceProxy(this as this & Resource<TType>);\n    this._selfProxy = proxy;\n\n    // Tricky part for the proxy implementation:\n    // ProvisioningComponent constructor pushed `this` (bare instance) into parent.children\n    // before the proxy existed. Swap it for the proxy so external consumers\n    // see proxy-backed handles (with property access, etc.) when iterating.\n    const idx = context.children.indexOf(this);\n    if (idx >= 0) context.children[idx] = proxy;\n\n    return proxy;\n  }\n\n  override get self(): this {\n    return this._selfProxy ?? this;\n  }\n\n  /**\n   * The Azure resource name as a Bicep symbolic-reference expression.\n   *\n   * The value is established at construction time (either user-supplied\n   * via `props.name` or filled in by the naming policy) and stored on\n   * `state.name`. The setter routes through `setProperty` so post-\n   * construction edits flow through the same proxy/expression machinery\n   * as any other property — useful when working with a base `Resource`\n   * reference and re-binding the name dynamically. Singleton subclasses\n   * override this getter to narrow the return type to the literal\n   * `Expression<\"<singletonName>\">`; non-singleton subclasses inherit\n   * this accessor pair as-is.\n   */\n  get name(): Expression<string> {\n    return this.expr(\"name\");\n  }\n  set name(value: ExpressionOrValue<string>) {\n    this.setProperty(\"name\", value);\n  }\n\n  get id(): Expression<string> {\n    return this.expr(\"id\");\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Loop\n// ---------------------------------------------------------------------------\n\n/**\n * Metadata describing a Bicep `[for … in …]` loop and the concrete\n * variable names used inside it. Stored publicly on {@link LoopedResource.loop}\n * once a looped resource declaration has been created.\n */\nexport interface LoopContext {\n  readonly collection: unknown;\n  readonly itemVariable: string;\n  readonly indexVariable?: string;\n  readonly batchSize?: number;\n}\n\n/**\n * Options accepted by `new Loop(collection, options?)`. All fields are\n * optional overrides; the constructor supplies defaults. Derived from\n * {@link LoopContext} so there is exactly one source of truth for the\n * shape of loop metadata.\n */\nexport type LoopOptions = Partial<Omit<LoopContext, \"collection\">>;\n\n/**\n * Describes a Bicep `[for item in collection: ...]` loop as a plain data\n * object. Construct one and pass it to\n * `Ctor.fromLoop(loop, context, props, options?)` (e.g.\n * `StorageAccount.fromLoop(...)`) to expand a resource declaration into a\n * resource-copy loop.\n *\n * The item and index variable names default to `item` / `i`. Bicep\n * for-expressions bind their loop variables only within their own body,\n * so two sibling `[for item in xs: …]` / `[for item in ys: …]` in the\n * same file do **not** collide — each `item` is scoped to its own\n * expression. If you nest a `Loop` inside another loop's body (rare),\n * pass `{ itemVariable, indexVariable }` explicitly on the inner one to\n * disambiguate. `batchSize` on the loop renders as `@batchSize(n)` on\n * the resource that consumes it.\n *\n * The `indexVariable` name is always materialized on read (never\n * `undefined`), but whether the wire actually **records** it — and\n * therefore whether the renderer emits the `[for (item, i) in …]` tuple\n * binding — is decided by whether anyone accessed `loop.index` (or the\n * caller supplied `{ indexVariable }` explicitly). A loop whose body\n * never mentions an index emits a bare `[for item in xs: …]`.\n *\n * `Loop` instances are pure data — creating one has no side effect.\n */\nexport class Loop<T> {\n  readonly collection: ExpressionOrValue<T[]>;\n  readonly itemVariable: string;\n  readonly item: Expression<T>;\n  readonly batchSize?: number;\n\n  // The default name assigned to `indexVariable` on first materialization,\n  // if the caller neither passed `{ indexVariable }` nor accessed `.index`.\n  readonly #defaultIndexVariable: string;\n  #indexVariable: string | undefined;\n  #indexExpr: Expression<number> | undefined;\n  #indexRequested = false;\n\n  constructor(collection: ExpressionOrValue<T[]>, options?: LoopOptions) {\n    this.collection = collection;\n\n    this.itemVariable = options?.itemVariable ?? \"item\";\n    this.#defaultIndexVariable = \"i\";\n\n    if (options?.indexVariable !== undefined) {\n      // Explicit option counts as a request — the wire and renderer must\n      // honor the caller's chosen name whether or not they read `.index`.\n      this.#indexVariable = options.indexVariable;\n      this.#indexRequested = true;\n    }\n    if (options?.batchSize !== undefined) {\n      this.batchSize = options.batchSize;\n    }\n\n    this.item = wrapExpression(symbolicValueExpressionNode(this.itemVariable)) as Expression<T>;\n  }\n\n  /**\n   * Name of the loop's index variable. Always defined — reading it\n   * materializes the default (`i`) if the caller neither passed\n   * `{ indexVariable }` nor accessed `.index` yet.\n   *\n   * Reading `.indexVariable` also marks the index as requested (same as\n   * reading `.index`), because a caller who wants the variable name is\n   * almost certainly going to use it. If the wire-omit optimization\n   * (bare `[for item in …]` with no index binding) matters, callers\n   * should gate on `.indexRequested` first before touching this getter.\n   */\n  get indexVariable(): string {\n    this.#indexRequested = true;\n    if (this.#indexVariable === undefined) {\n      this.#indexVariable = this.#defaultIndexVariable;\n    }\n    return this.#indexVariable;\n  }\n\n  /**\n   * Expression referencing the current iteration's index. Reading this the\n   * first time marks the index as requested, which causes the wire to\n   * include `indexVariable` on the `for-expression` node and the renderer\n   * to emit `[for (item, i) in …]`. Callers who never touch `.index` get\n   * the cleaner index-less form.\n   */\n  get index(): Expression<number> {\n    this.#indexRequested = true;\n    if (this.#indexExpr === undefined) {\n      const name = this.indexVariable;\n      this.#indexExpr = wrapExpression(symbolicValueExpressionNode(name)) as Expression<number>;\n    }\n    return this.#indexExpr;\n  }\n\n  /**\n   * Framework-internal signal used by `Resource.fromLoop` to decide\n   * whether the wire should include the index binding. `true` when the\n   * caller either supplied `{ indexVariable }` explicitly or has accessed\n   * `.index` / `.indexVariable` at least once. Not exported from\n   * `@azure/provisioning-core`.\n   *\n   * @internal\n   */\n  get indexRequested(): boolean {\n    return this.#indexRequested;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// LoopedResource<T> — a Bicep for-expanded resource declaration as a real\n// ProvisioningComponent in the tree, sitting alongside scalar `Resource` under the same\n// `ResourceDeclaration` base.\n// ---------------------------------------------------------------------------\n\n/**\n * A `LoopedResource<T>` represents a single Bicep resource declaration\n * expanded across a loop (`[for x in xs: {...}]`). It is a real\n * `ProvisioningComponent` in the tree — one node per emitted declaration — and\n * exposes indexed access into individual iterations via\n * {@link LoopedResource.at}.\n *\n * @remarks\n *\n * Property access on a `LoopedResource` is deliberately not exposed at\n * the type level: pick an index (`at`) to obtain a proxy that emits\n * `sym[i].prop`. This mirrors Bicep's requirement that individual\n * iterations be accessed by index.\n *\n * `.at(i)` returns the concrete resource type `T`. The returned proxy\n * exposes the essential ARM surface — the property getters/setters that\n * funnel through `this.expr(...)` (`.id`, `.name`, `.sku`,\n * `.properties.*`, …) rooted at `sym[i]` — as well as the child\n * accessors (`keyVault.secrets`, singleton getter/setters), which are\n * derived from the parent's `children` scoped to element `i`. To attach\n * per-iteration children, parent them to `parent.at(loop.index)` — e.g.\n * `Child.fromLoop(loop, parent.at(loop.index), ...)`.\n *\n * Projection over the loop (Bicep `map(sym, x => body)`) is tracked as\n * a follow-up effort — see the \"lambda + fn.map\" issue.\n */\nexport class LoopedResource<T extends Resource = Resource> extends ResourceDeclaration<T[\"type\"]> {\n  /**\n   * Cross-realm brand — same technique as the scalar `RESOURCE_BRAND`.\n   * Use {@link isLoopedResource} instead of `instanceof`\n   * when multiple copies of `@azure/provisioning-core` may be loaded.\n   */\n  readonly [LOOPED_RESOURCE_BRAND] = true as const;\n\n  /** Metadata describing the loop that produced this declaration. */\n  readonly loop: LoopContext;\n\n  readonly #wrappedCtor: new (\n    context: ProvisioningComponent,\n    props: unknown,\n    options?: ResourceOptions,\n  ) => T;\n\n  private constructor(\n    context: ProvisioningComponent,\n    wrappedCtor: new (\n      context: ProvisioningComponent,\n      props: unknown,\n      options?: ResourceOptions,\n    ) => T,\n    userProps: unknown,\n    loop: LoopContext & {\n      readonly indexRequested: boolean;\n      readonly indexVariable: string;\n    },\n    options?: ResourceOptions,\n  ) {\n    // The subclass constructor never runs for a looped row — only this\n    // shared `ResourceDeclaration` ctor does. To keep the scalar and\n    // looped construction paths from drifting, shape the props bag through\n    // the SAME static the scalar ctor uses: every `Resource` (sub)class\n    // inherits or overrides `buildResourceProps`, which returns the exact\n    // `super()` payload the scalar ctor passes — including the fixed `name`\n    // for singletons and any other prop shaping. (This is what fixes looped\n    // singletons losing their fixed `name`.)\n    //\n    // It is always present: base `Resource` — the deserialize fallback ctor\n    // for an unregistered `(type, apiVersion)` pair — supplies a default\n    // that threads `type` / `apiVersion` in from `userProps`. So there's no\n    // existence branch here.\n    const props = (\n      wrappedCtor as unknown as {\n        buildResourceProps: (props: unknown) => ResourceProps<T[\"type\"]> & Record<string, unknown>;\n      }\n    ).buildResourceProps.call(wrappedCtor, userProps);\n    if (props.name === undefined) {\n      throw new Error(`Looped resource '${props.type}' requires an explicit per-iteration name.`);\n    }\n    const namingRules = (wrappedCtor as unknown as { namingRules?: ResourceNamingRules })\n      .namingRules;\n    (\n      wrappedCtor as unknown as {\n        validate(\n          context: ProvisioningComponent,\n          props: ResourceProps<string> & Record<string, unknown>,\n          options?: ResourceOptions,\n          namingRules?: ResourceNamingRules,\n        ): void;\n      }\n    ).validate.call(wrappedCtor, context, props, options, namingRules);\n    super(context, props, options, namingRules);\n    this.#wrappedCtor = wrappedCtor;\n    // Snapshot the loop metadata at declaration time. `indexVariable` is\n    // recorded only if the index was requested by now — either the caller\n    // supplied `{ indexVariable }` or read `loop.index` / `loop.indexVariable`\n    // before this declaration. Reading `loop.index` (e.g. via\n    // `parent.at(loop.index)`) marks the live loop so descendant\n    // declarations (which snapshot the same loop afterwards) pick up the\n    // binding, while this declaration's own for-expression stays index-less.\n    this.loop = {\n      collection: loop.collection,\n      itemVariable: loop.itemVariable,\n      ...(loop.indexRequested ? { indexVariable: loop.indexVariable } : {}),\n      ...(loop.batchSize !== undefined ? { batchSize: loop.batchSize } : {}),\n    };\n  }\n\n  /**\n   * The concrete `Resource` subclass this looped declaration wraps.\n   * Used by query machinery to answer \"which subclass is this looped\n   * resource\" — the analogue of `instanceof T` for `LoopedResource<T>`.\n   *\n   * This is always the full subclass the user constructed via\n   * `Xxx.fromLoop(...)` — query identity matches on that class, and it is\n   * the prototype the `.at(i)` proxy uses to resolve ARM accessors.\n   */\n  get wrappedCtor(): new (\n    context: ProvisioningComponent,\n    props: unknown,\n    options?: ResourceOptions,\n  ) => T {\n    return this.#wrappedCtor;\n  }\n\n  /**\n   * Reference the element at `index`. Emits `sym[index].<...>` for\n   * subsequent property access.\n   *\n   * Returns the concrete resource type `T`. At runtime an indexed proxy is\n   * spliced over the full class prototype (`#wrappedCtor.prototype`):\n   * prototype getters that funnel through `this.expr(...)` (`.id`, `.name`,\n   * `.properties.*`, …) resolve rooted at `sym[index]`. A child created with\n   * `parent.at(i)` is stamped with that index for serialization.\n   */\n  at(index: ExpressionOrValue<number>): T {\n    // `this` is a `ResourceDeclaration`; the handle derives the subclass\n    // prototype from `this.wrappedCtor`. The explicit type argument pins\n    // the return type, which TypeScript can't otherwise resolve from the\n    // deferred polymorphic `this`.\n    return createIndexedResourceProxy<LoopedResource<T>>(this, index);\n  }\n}\n\n/** @internal */\nexport function createLoopedResource<T extends Resource, C extends ProvisioningComponent, P, Item>(\n  wrappedCtor: new (context: C, props: P, options?: ResourceOptions) => T,\n  loop: Loop<Item>,\n  context: C,\n  ...rest: undefined extends P\n    ? [props?: P, options?: ResourceOptions]\n    : [props: P, options?: ResourceOptions]\n): LoopedResource<T> {\n  const [userProps, options] = rest as [P?, ResourceOptions?];\n  // `LoopedResource`'s ctor is private; access via cast because this module\n  // owns both the declaration and its internal construction boundary.\n  const LoopedCtor = LoopedResource as unknown as new <U extends Resource>(\n    context: ProvisioningComponent,\n    wrappedCtor: new (\n      context: ProvisioningComponent,\n      props: unknown,\n      options?: ResourceOptions,\n    ) => U,\n    userProps: unknown,\n    loop: LoopContext & {\n      readonly indexRequested: boolean;\n      readonly indexVariable: string;\n    },\n    options?: ResourceOptions,\n  ) => LoopedResource<U>;\n  return new LoopedCtor(\n    context,\n    wrappedCtor as new (\n      context: ProvisioningComponent,\n      props: unknown,\n      options?: ResourceOptions,\n    ) => T,\n    userProps,\n    loop,\n    options,\n  );\n}\n"]}

package/dist/browser/constructs/stack.d.ts.map

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

package/dist/browser/constructs/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../../src/constructs/stack.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,kBAAkB,IAAI,qBAAqB,EAC3C,YAAY,IAAI,eAAe,EAC/B,WAAW,IAAI,cAAc,GAE9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,oBAAoB,GAKrB,MAAM,wBAAwB,CAAC;AAehC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,KAAM,SAAQ,qBAAqB;IACrC,IAAI,CAAS;IACb,WAAW,CAAc;IACzB,UAAU,GAAwB,IAAI,mBAAmB,EAAE,CAAC;IAC5D,SAAS,GAAuB,IAAI,kBAAkB,EAAE,CAAC;IACzD,OAAO,GAAqB,IAAI,gBAAgB,EAAE,CAAC;IAE5D,qCAAqC;IAErC,MAAM,CAAC,MAAM,GAAY,EAAE,CAAC;IAE5B,2EAA2E;IAC3E,MAAM,KAAK,KAAK;QACd,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED,2BAA2B;IAC3B,YAAY,IAAY,EAAE,OAAsB;QAC9C,KAAK,EAAE,CAAC;QACR,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,cAAc,CAAC;QACtD,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,uBAAuB,GAAG;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,mBAAmB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;SAC/E,CAAC;IACJ,CAAC;IAoBD,YAAY,CACV,aAAqD,EACrD,YAA2B;QAE3B,OAAO,eAAe,CAAC,IAAI,EAAE,aAAsB,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,WAAW,CACT,IAAqB,EACrB,IAAY,EACZ,OAAsB;QAEtB,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAYD,GAAG,CACD,IAAmF,EACnF,GAAG,IAAW;QAEd,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;;AAcH,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,aAAqD,EACrD,YAA2B;IAE3B,OAAO,qBAAqB,CAAC,KAAK,EAAE,aAAsB,EAAE,YAAY,CAAC,CAAC;AAC5E,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,iBAAiB,CAC/B,KAAY,EACZ,IAAoE,EACpE,IAAmB,EACnB,GAAG,IAEsC;IAEzC,OAAO,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { ProvisioningComponent } from \"./provisioning-component.js\";\nimport type { ExpressionOrValue } from \"../expression/expressions.js\";\nimport type { NamingPolicy } from \"../naming/naming-policy.js\";\nimport { DefaultNamingPolicy } from \"../naming/naming-policy.js\";\nimport { OutputCollection } from \"./output.js\";\nimport { ParameterCollection } from \"./parameter.js\";\nimport { VariableCollection } from \"./variable.js\";\nimport {\n  getLoopedResources as runGetLoopedResources,\n  getResources as runGetResources,\n  getResource as runGetResource,\n  type QueryOptions,\n} from \"./resource/resource-query.js\";\nimport {\n  createLoopedResource,\n  type Loop,\n  type LoopedResource,\n  type Resource,\n  type ResourceOptions,\n} from \"./resource/resource.js\";\nimport type { ResourceCtor } from \"./resource/resource-registry.js\";\nimport type { TargetScope } from \"../serialization/ast/index.js\";\n\n// ---------------------------------------------------------------------------\n// Stack — class-based API for creating stacks\n// ---------------------------------------------------------------------------\n\nexport interface StackOptions {\n  readonly targetScope?: TargetScope | undefined;\n  readonly location?: ExpressionOrValue<string> | undefined;\n  readonly tags?: Record<string, ExpressionOrValue<string>> | undefined;\n  readonly namingPolicy?: NamingPolicy | undefined;\n}\n\n/**\n * A Stack defines a deployment unit.\n *\n * @remarks\n * Each stack produces one or more Bicep files — resources at different\n * scopes (subscription vs. resource group) are split into separate files\n * linked by module references.\n *\n * Resources register themselves by passing the stack (or a child component)\n * as their first constructor argument. `Stack.add()` is available as a\n * convenience for creating child components with the stack as parent.\n *\n * The `targetScope` option controls the Bicep target scope. Default is\n * `\"subscription\"`, which requires explicit `ResourceGroup` instances.\n * Set `\"resourceGroup\"` to deploy resources directly into an existing\n * resource group.\n *\n * Every stack registers itself in `Stack.roots` for collection by tools\n * like the playground and CLI.\n *\n * {@link https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/keyvault/provisioning-keyvault#getting-started | Key Vault getting started example}\n */\nexport class Stack extends ProvisioningComponent {\n  readonly name: string;\n  readonly targetScope: TargetScope;\n  readonly parameters: ParameterCollection = new ParameterCollection();\n  readonly variables: VariableCollection = new VariableCollection();\n  readonly outputs: OutputCollection = new OutputCollection();\n\n  // --- Static root stack registry ---\n\n  static #roots: Stack[] = [];\n\n  /** All root stacks created since the last call to `Stack.clearRoots()`. */\n  static get roots(): readonly Stack[] {\n    return Stack.#roots;\n  }\n\n  /**\n   * Returns all root stacks and clears the registry. Useful for collecting\n   * all stacks after executing user code (e.g. in the playground or CLI).\n   */\n  static clearRoots(): Stack[] {\n    return Stack.#roots.splice(0, Stack.#roots.length);\n  }\n\n  /** Create a root stack. */\n  constructor(name: string, options?: StackOptions) {\n    super();\n    const opts = options ?? {};\n    this.name = name;\n    this.targetScope = opts.targetScope ?? \"subscription\";\n    Stack.#roots.push(this);\n    this._localDeploymentContext = {\n      location: opts.location,\n      tags: opts.tags,\n      namingPolicy: opts.namingPolicy ?? new DefaultNamingPolicy({ workload: name }),\n    };\n  }\n\n  // --- Query ---\n  // Query the resources in this stack. Exposed on `Stack` (not `ProvisioningComponent`)\n  // because \"all resources in the stack\" is unambiguous, whereas\n  // `resource.getResources()` — which excludes the resource itself —\n  // would be confusing. For multiple stacks, use\n  // `stacks.flatMap(s => s.getResources(...))`.\n\n  /**\n   * The scalar resources in this stack. With no `type`, returns\n   * every scalar resource; pass a resource class to filter and narrow to\n   * that subclass. Returns a plain array — use native `.filter` / `.find` /\n   * `.map` for anything further.\n   *\n   * By default walks the whole tree; pass `{ recursive: false }` to consider\n   * only the stack's direct children.\n   */\n  getResources(options?: QueryOptions): Resource[];\n  getResources<T extends Resource>(type: ResourceCtor<T>, options?: QueryOptions): T[];\n  getResources(\n    typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n    maybeOptions?: QueryOptions,\n  ): Resource[] {\n    return runGetResources(this, typeOrOptions as never, maybeOptions);\n  }\n\n  /**\n   * Find the **first** scalar resource of `type` whose literal name equals\n   * `name`, or `undefined` if none matches.\n   *\n   * @remarks\n   * Returns the first match in tree order. ARM names are unique only *per\n   * resource type within a scope*, so a stack MAY legitimately contain more\n   * than one resource of the same `type` and `name` (e.g. across different\n   * resource groups) — this returns whichever is found first. Use\n   * `getResources(type)` and filter yourself if you need all matches.\n   *\n   * Only scalar resources are searched, and names that do not resolve to a\n   * string literal are never matched. Pass `{ recursive: false }` to search\n   * only the stack's direct children.\n   */\n  getResource<T extends Resource>(\n    type: ResourceCtor<T>,\n    name: string,\n    options?: QueryOptions,\n  ): T | undefined {\n    return runGetResource(this, type, name, options);\n  }\n\n  /**\n   * Create a child under this stack (with the stack as its parent context),\n   * as a convenience for `new Ctor(stack, ...args)`.\n   *\n   * Constructs a single child instance and returns it.\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  add(\n    ctor: new (context: ProvisioningComponent, ...args: any[]) => ProvisioningComponent,\n    ...rest: any[]\n  ): ProvisioningComponent {\n    return new ctor(this.self, ...rest);\n  }\n}\n\n/** @internal */\nexport function getLoopedResources(\n  stack: Stack,\n  options?: QueryOptions,\n): LoopedResource<Resource>[];\n/** @internal */\nexport function getLoopedResources<T extends Resource>(\n  stack: Stack,\n  type: ResourceCtor<T>,\n  options?: QueryOptions,\n): LoopedResource<T>[];\nexport function getLoopedResources(\n  stack: Stack,\n  typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n  maybeOptions?: QueryOptions,\n): LoopedResource<Resource>[] {\n  return runGetLoopedResources(stack, typeOrOptions as never, maybeOptions);\n}\n\n/** @internal */\nexport function addLoopedResource<T extends Resource, P>(\n  stack: Stack,\n  ctor: new (context: Stack, props: P, options?: ResourceOptions) => T,\n  loop: Loop<unknown>,\n  ...rest: undefined extends P\n    ? [props?: P, options?: ResourceOptions]\n    : [props: P, options?: ResourceOptions]\n): LoopedResource<T> {\n  return createLoopedResource(ctor, loop, stack.self, ...rest);\n}\n"]}

package/dist/browser/constructs/variable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable.d.ts","sourceRoot":"","sources":["../../../src/constructs/variable.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,aAAa,EAAE,GACxB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAAE,GACzC,OAAO,CAAC,OAAO,CAAC,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAOD,MAAM,MAAM,QAAQ,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,IAAI,UAAU,CAC7E,eAAe,CAAC,MAAM,CAAC,CACxB,CAAC;AAEF;;;;GAIG;AACH,qBAAa,kBAAkB;;IAG7B,+EAA+E;IAC/E,GAAG,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,EAC9C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,MAAM,CAAC;IAYnB,4DAA4D;IAC5D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,+DAA+D;IAC/D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIvD,gDAAgD;IAChD,IAAI,IAAI,SAAS,QAAQ,EAAE;IAI3B,oDAAoD;IACpD,YAAY,IAAI,SAAS,gBAAgB,EAAE;IAI3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kEAAkE;IAClE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO7B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC;CAOhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa,EACzE,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,eAAe,GACxB,QAAQ,CAAC,MAAM,CAAC,CAElB"}

package/dist/browser/constructs/variable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable.js","sourceRoot":"","sources":["../../../src/constructs/variable.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Expression, InputOf } from \"../expression/expressions.js\";\nimport { wrapExpression } from \"../expression/expressions.js\";\nimport { symbolicValueExpressionNode } from \"../expression/ast-nodes.js\";\nimport type { Stack } from \"./stack.js\";\nimport { assertBicepIdentifier } from \"../util.js\";\n\nexport type ExpressionValue<T> = T extends Expression<infer U> ? U : T;\n\n/**\n * A value accepted as a deployment variable's value: any JSON literal\n * (scalar, `null`, array, object — recursively), an `Expression`, or a\n * resource view (`InputOf<unknown>`). The literal members are required so\n * plain object/array literals are accepted (a bare `InputOf<unknown>` is a\n * weak type and would reject them).\n */\nexport type VariableValue =\n  | string\n  | number\n  | boolean\n  | null\n  | readonly VariableValue[]\n  | { readonly [key: string]: VariableValue }\n  | InputOf<unknown>;\n\nexport type VariableOptions = {\n  readonly description?: string | undefined;\n  readonly export?: boolean | undefined;\n};\n\n/**\n * Pure declaration data for a deployment variable. Stored on the stack\n * (paired with the returned expression handle in {@link VariableEntry});\n * read by the serializer at emit time. Not part of the value-level handle.\n */\nexport interface VariableMetadata extends VariableOptions {\n  readonly name: string;\n  readonly value: VariableValue;\n}\n\ninterface VariableEntry {\n  readonly metadata: VariableMetadata;\n  readonly variable: Expression<unknown>;\n}\n\nexport type Variable<TValue extends VariableValue = VariableValue> = Expression<\n  ExpressionValue<TValue>\n>;\n\n/**\n * Authoring-time collection of a stack's deployment variables. Backed by an\n * ordered private array; supports add/get/delete/iteration. Look variables up\n * by name via {@link VariableCollection.get}.\n */\nexport class VariableCollection {\n  #entries: VariableEntry[] = [];\n\n  /** Add a variable; returns its expression handle. Throws on duplicate name. */\n  add<TValue extends VariableValue = VariableValue>(\n    name: string,\n    value: TValue,\n    options?: VariableOptions,\n  ): Variable<TValue> {\n    assertBicepIdentifier(name, \"Deployment variable\");\n    if (this.has(name)) {\n      throw new Error(`Duplicate deployment variable name: ${name}`);\n    }\n    const variable = wrapExpression<ExpressionValue<TValue>>(\n      symbolicValueExpressionNode<ExpressionValue<TValue>, string>(name),\n    );\n    this.#entries.push({ metadata: { name, value, ...options }, variable });\n    return variable;\n  }\n\n  /** The expression handle for a variable, or `undefined`. */\n  get(name: string): Variable | undefined {\n    return this.#find(name)?.variable;\n  }\n\n  /** The declaration metadata for a variable, or `undefined`. */\n  getMetadata(name: string): VariableMetadata | undefined {\n    return this.#find(name)?.metadata;\n  }\n\n  /** All variable handles, in insertion order. */\n  list(): readonly Variable[] {\n    return this.#entries.map((e) => e.variable);\n  }\n\n  /** All declaration metadata, in insertion order. */\n  listMetadata(): readonly VariableMetadata[] {\n    return this.#entries.map((e) => e.metadata);\n  }\n\n  has(name: string): boolean {\n    return this.#find(name) !== undefined;\n  }\n\n  /** Remove a variable by name. Returns whether one was removed. */\n  delete(name: string): boolean {\n    const i = this.#entries.findIndex((e) => e.metadata.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<Variable> {\n    return this.#entries.map((e) => e.variable)[Symbol.iterator]();\n  }\n\n  #find(name: string): VariableEntry | undefined {\n    return this.#entries.find((e) => e.metadata.name === name);\n  }\n}\n\n/**\n * A computed value evaluated at deploy time, compiled to a Bicep `var` declaration.\n *\n * @example\n * ```typescript snippet:ignore\n * import { Stack, createVariable } from \"@azure/provisioning-core\";\n *\n * const stack = new Stack(\"my-app\");\n * const suffix = createVariable(stack, \"suffix\", \"prod\");\n * ```\n */\nexport function createVariable<TValue extends VariableValue = VariableValue>(\n  stack: Stack,\n  name: string,\n  value: TValue,\n  options?: VariableOptions,\n): Variable<TValue> {\n  return stack.variables.add(name, value, options);\n}\n"]}

package/dist/browser/deployment-context/deployment-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-context.d.ts","sourceRoot":"","sources":["../../../src/deployment-context/deployment-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CAClD"}

package/dist/browser/deployment-context/deployment-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-context.js","sourceRoot":"","sources":["../../../src/deployment-context/deployment-context.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ExpressionOrValue } from \"../expression/expressions.js\";\nimport type { NamingPolicy } from \"../naming/naming-policy.js\";\n\n/**\n * Inherited environment that flows down the component tree.\n *\n * @remarks\n * Each node may attach a local contribution via `ProvisioningComponent._localDeploymentContext`\n * (today, only `Stack` and `ResourceGroup` do). When a `Resource` reads the\n * effective context, the framework walks ancestors and resolves each field:\n *\n * - `location`: nearest ancestor with a value wins.\n * - `namingPolicy`: nearest ancestor with a value wins.\n * - `tags`: flat-merged across **all** ancestors; innermost wins on key conflict.\n *\n * Per-resource Bicep `scope:` is not part of this — a resource's deployment\n * scope is determined by which file or module it lands in, which in turn is\n * determined by the ProvisioningComponent tree (the nearest `ResourceGroup`/`Stack` ancestor).\n *\n * The same interface describes both a node's local contribution and the\n * fully-resolved view returned by `ProvisioningComponent.deploymentContext`.\n */\nexport interface DeploymentContext {\n  readonly location?: ExpressionOrValue<string> | undefined;\n  readonly tags?: Record<string, ExpressionOrValue<string>> | undefined;\n  readonly namingPolicy?: NamingPolicy | undefined;\n}\n"]}

package/dist/browser/expression/ast-nodes.d.ts.map

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

package/dist/{expression → browser/expression}/ast-nodes.js

@@ -43,15 +43,13 @@ export function isExpressionNode(value) {
                 typeof node.nullish === "boolean" &&
                 typeof node.fromEnd === "boolean");
         case "binary":
-            return (typeof node.operator === "string" && "left" in node && "right" in node);
+            return typeof node.operator === "string" && "left" in node && "right" in node;
         case "unary":
             return typeof node.operator === "string" && "argument" in node;
         case "ternary":
             return "condition" in node && "trueValue" in node && "falseValue" in node;
         case "instance-function-call":
-            return (isExpressionNode(node.base) &&
-                typeof node.name === "string" &&
-                Array.isArray(node.args));
+            return (isExpressionNode(node.base) && typeof node.name === "string" && Array.isArray(node.args));
         case "interpolated-string":
             return Array.isArray(node.segments);
         default:

package/dist/browser/expression/ast-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-nodes.js","sourceRoot":"","sources":["../../../src/expression/ast-nodes.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Resource } from \"../constructs/resource/resource.js\";\nimport type { BinaryOperator, UnaryOperator } from \"../serialization/ast/index.js\";\nimport type { PropertySegment } from \"../types.js\";\n\nexport type { BinaryOperator, UnaryOperator };\n\n// ---------------------------------------------------------------------------\n// Expression node interfaces (the raw discriminated union members)\n// ---------------------------------------------------------------------------\n\n// Note: every interface declares a phantom `TValue` (when otherwise it wouldn't\n// need one). `TValue` is *not* used in any field of any interface — but its\n// presence in the variant *type-parameter slot* is what allows\n// `ExpressionNode<T>` to thread `T` through to each variant, which in turn is\n// what lets `ExpressionBrand<T>` carry inference-visible `T` across project-\n// reference boundaries. Removing `TValue` and making `ExpressionNode<T>` a\n// fully-phantom alias breaks `coalesce<T>(...)` inference and the\n// `as DeploymentParameter<...>` cast in cross-project consumers (e.g. `demo`).\n\nexport interface FunctionCallExpressionNode<_TValue = unknown, TOperator extends string = string> {\n  readonly kind: \"fn-call\";\n  readonly operator: TOperator;\n  readonly args: readonly unknown[];\n}\n\nexport interface SymbolicValueExpressionNode<_TValue = unknown, TPath extends string = string> {\n  readonly kind: \"symbolic-value\";\n  readonly path: TPath;\n}\n\nexport interface IdentifierExpressionNode<_TValue = unknown> {\n  readonly kind: \"identifier\";\n  readonly id: string | Resource;\n}\n\nexport interface PropertyAccessExpressionNode<_TValue = unknown> {\n  readonly kind: \"property-access\";\n  readonly base: ExpressionNode;\n  readonly property: string;\n  readonly nullish: boolean;\n  /**\n   * Optional ARM wire-path segments. When present, the serialization\n   * lowering pass rewrites this single access into a chain that walks\n   * these segments (handling renames + `@flattenProperty` hoisting).\n   * Untyped / hand-built expressions leave this `undefined` and pass\n   * through unchanged.\n   */\n  readonly armPath?: readonly string[] | undefined;\n}\n\nexport interface ArrayAccessExpressionNode<_TValue = unknown> {\n  readonly kind: \"array-access\";\n  readonly base: ExpressionNode;\n  /**\n   * The index into the array. A literal `number`/`string` lowers to an\n   * integer/string array-access (or a property-access for identifier-like\n   * strings) at serialize time. Any {@link ExpressionNode} is serialized\n   * recursively into the wire array-access's `index` slot — e.g. a looped\n   * `.at(loop.index)` stores the unwrapped `symbolic-value` node (emitting\n   * `sym[i]`), and a computed offset stores a `binary` / `fn-call` node\n   * (`sym[i + 1]`). `Expression<T>` proxies are always unwrapped to their\n   * raw node before landing here, per the \"state holds normalized raw\n   * nodes\" invariant — so a proxy is never stored directly.\n   */\n  readonly index: ArrayAccessIndex;\n  readonly nullish: boolean;\n  readonly fromEnd: boolean;\n}\n\nexport interface BinaryExpressionNode<_TValue = unknown> {\n  readonly kind: \"binary\";\n  readonly operator: BinaryOperator;\n  readonly left: unknown;\n  readonly right: unknown;\n}\n\nexport interface UnaryExpressionNode<_TValue = unknown> {\n  readonly kind: \"unary\";\n  readonly operator: UnaryOperator;\n  readonly argument: unknown;\n}\n\nexport interface TernaryExpressionNode<_TValue = unknown> {\n  readonly kind: \"ternary\";\n  readonly condition: unknown;\n  readonly trueValue: unknown;\n  readonly falseValue: unknown;\n}\n\nexport interface InstanceFunctionCallExpressionNode<_TValue = unknown> {\n  readonly kind: \"instance-function-call\";\n  readonly base: ExpressionNode;\n  readonly name: string;\n  readonly args: readonly unknown[];\n}\n\nexport interface InterpolatedStringExpressionNode<_TValue = unknown> {\n  readonly kind: \"interpolated-string\";\n  readonly segments: readonly unknown[];\n}\n\n// ---------------------------------------------------------------------------\n// ExpressionNode union\n// ---------------------------------------------------------------------------\n\n// `T` is threaded through every variant. See the long comment above the node\n// interfaces for why this matters.\nexport type ExpressionNode<T = unknown> =\n  | FunctionCallExpressionNode<T>\n  | SymbolicValueExpressionNode<T>\n  | IdentifierExpressionNode<T>\n  | PropertyAccessExpressionNode<T>\n  | ArrayAccessExpressionNode<T>\n  | BinaryExpressionNode<T>\n  | UnaryExpressionNode<T>\n  | TernaryExpressionNode<T>\n  | InstanceFunctionCallExpressionNode<T>\n  | InterpolatedStringExpressionNode<T>;\n\n/**\n * The index stored on an {@link ArrayAccessExpressionNode}: a literal\n * `number` or `string`, or a raw {@link ExpressionNode} evaluated at\n * serialize time (e.g. a loop's `symbolic-value` index, or a `binary` /\n * `fn-call` node for a computed offset). `Expression<T>` proxies are\n * unwrapped to their raw node before being stored, so the proxy type is\n * intentionally absent here.\n */\nexport type ArrayAccessIndex = number | string | ExpressionNode;\n\n// Typed as `Record<ExpressionNode[\"kind\"], true>` so adding a new variant to\n// `ExpressionNode` forces a compile error here until the new kind is listed.\nconst EXPRESSION_NODE_KINDS: Record<ExpressionNode[\"kind\"], true> = {\n  \"fn-call\": true,\n  \"symbolic-value\": true,\n  identifier: true,\n  \"property-access\": true,\n  \"array-access\": true,\n  binary: true,\n  unary: true,\n  ternary: true,\n  \"instance-function-call\": true,\n  \"interpolated-string\": true,\n};\n\n/** Tests whether a value structurally matches a raw expression AST node. */\nexport function isExpressionNode(value: unknown): value is ExpressionNode {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !Object.prototype.hasOwnProperty.call(value, \"kind\") ||\n    typeof (value as { kind: unknown }).kind !== \"string\"\n  ) {\n    return false;\n  }\n  const node = value as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(EXPRESSION_NODE_KINDS, node.kind as string)) {\n    return false;\n  }\n  switch (node.kind) {\n    case \"fn-call\":\n      return typeof node.operator === \"string\" && Array.isArray(node.args);\n    case \"symbolic-value\":\n      return typeof node.path === \"string\";\n    case \"identifier\":\n      return typeof node.id === \"string\" || typeof node.id === \"object\";\n    case \"property-access\":\n      return (\n        isExpressionNode(node.base) &&\n        typeof node.property === \"string\" &&\n        typeof node.nullish === \"boolean\"\n      );\n    case \"array-access\":\n      return (\n        isExpressionNode(node.base) &&\n        \"index\" in node &&\n        typeof node.nullish === \"boolean\" &&\n        typeof node.fromEnd === \"boolean\"\n      );\n    case \"binary\":\n      return typeof node.operator === \"string\" && \"left\" in node && \"right\" in node;\n    case \"unary\":\n      return typeof node.operator === \"string\" && \"argument\" in node;\n    case \"ternary\":\n      return \"condition\" in node && \"trueValue\" in node && \"falseValue\" in node;\n    case \"instance-function-call\":\n      return (\n        isExpressionNode(node.base) && typeof node.name === \"string\" && Array.isArray(node.args)\n      );\n    case \"interpolated-string\":\n      return Array.isArray(node.segments);\n    default:\n      return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Factory functions\n// ---------------------------------------------------------------------------\n\nexport function functionCallExpressionNode<TValue = unknown, TOperator extends string = string>(\n  operator: TOperator,\n  args: readonly unknown[],\n): FunctionCallExpressionNode<TValue, TOperator> {\n  return { kind: \"fn-call\", operator, args };\n}\n\nexport function symbolicValueExpressionNode<TValue = unknown, TPath extends string = string>(\n  path: TPath,\n): SymbolicValueExpressionNode<TValue, TPath> {\n  return { kind: \"symbolic-value\", path };\n}\n\nexport function identifierExpressionNode<TValue = unknown>(\n  identifier: string | Resource,\n): IdentifierExpressionNode<TValue> {\n  return { kind: \"identifier\", id: identifier };\n}\n\nexport function propertyAccessExpressionNode<TValue = unknown>(\n  base: ExpressionNode,\n  property: string,\n  options: Partial<Pick<PropertyAccessExpressionNode, \"armPath\" | \"nullish\">> = {},\n): PropertyAccessExpressionNode<TValue> {\n  return {\n    kind: \"property-access\",\n    base,\n    property,\n    nullish: options.nullish ?? false,\n    ...(options.armPath === undefined ? {} : { armPath: options.armPath }),\n  };\n}\n\nexport function arrayAccessExpressionNode<TValue = unknown>(\n  base: ExpressionNode,\n  index: ArrayAccessIndex,\n  options: Partial<Pick<ArrayAccessExpressionNode, \"nullish\" | \"fromEnd\">> = {},\n): ArrayAccessExpressionNode<TValue> {\n  return {\n    kind: \"array-access\",\n    base,\n    index,\n    nullish: options.nullish ?? false,\n    fromEnd: options.fromEnd ?? false,\n  };\n}\n\nexport function binaryExpressionNode<TValue = unknown>(\n  operator: BinaryOperator,\n  left: unknown,\n  right: unknown,\n): BinaryExpressionNode<TValue> {\n  return { kind: \"binary\", operator, left, right };\n}\n\nexport function unaryExpressionNode<TValue = unknown>(\n  operator: UnaryOperator,\n  argument: unknown,\n): UnaryExpressionNode<TValue> {\n  return { kind: \"unary\", operator, argument };\n}\n\nexport function ternaryExpressionNode<TValue = unknown>(\n  condition: unknown,\n  trueValue: unknown,\n  falseValue: unknown,\n): TernaryExpressionNode<TValue> {\n  return {\n    kind: \"ternary\",\n    condition,\n    trueValue,\n    falseValue,\n  };\n}\n\nexport function instanceFunctionCallExpressionNode<TValue = unknown>(\n  base: ExpressionNode,\n  name: string,\n  args: readonly unknown[],\n): InstanceFunctionCallExpressionNode<TValue> {\n  return {\n    kind: \"instance-function-call\",\n    base,\n    name,\n    args,\n  };\n}\n\nexport function interpolatedStringExpressionNode<TValue = unknown>(\n  segments: readonly unknown[],\n): InterpolatedStringExpressionNode<TValue> {\n  return { kind: \"interpolated-string\", segments };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction isIdentifierSegment(segment: string): boolean {\n  return /^[A-Za-z_][A-Za-z0-9_]*$/u.test(segment);\n}\n\nexport function accessExpressionNode(\n  base: ExpressionNode,\n  member: PropertySegment,\n  options: Partial<Pick<PropertyAccessExpressionNode, \"armPath\" | \"nullish\">> = {},\n): PropertyAccessExpressionNode | ArrayAccessExpressionNode {\n  return typeof member === \"number\" || !isIdentifierSegment(member)\n    ? arrayAccessExpressionNode(base, member, options)\n    : propertyAccessExpressionNode(base, member, options);\n}\n"]}

package/dist/browser/expression/expressions.d.ts.map

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

package/dist/{expression → browser/expression}/expressions.js

@@ -81,7 +81,7 @@ export function unwrapExpression(expr) {
  * for that.
  */
 export function isExpression(value) {
-    return (typeof value === "object" && value !== null && EXPRESSION_BRAND in value);
+    return typeof value === "object" && value !== null && EXPRESSION_BRAND in value;
 }
 // ---------------------------------------------------------------------------
 // Expression proxy factory

package/dist/browser/expression/expressions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressions.js","sourceRoot":"","sources":["../../../src/expression/expressions.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { navigateShape, type NavShape } from \"../shape/shape.js\";\nimport {\n  arrayAccessExpressionNode,\n  binaryExpressionNode,\n  functionCallExpressionNode,\n  propertyAccessExpressionNode,\n  ternaryExpressionNode,\n  type BinaryOperator,\n  type ExpressionNode,\n  type UnaryOperator,\n  unaryExpressionNode,\n} from \"./ast-nodes.js\";\n\n// ---------------------------------------------------------------------------\n// Brand symbol (runtime + type-only)\n// ---------------------------------------------------------------------------\n\n/**\n * Runtime symbol key storing the underlying `ExpressionNode` on proxies.\n * Internal to the package — consumers should use `isExpression()` and\n * `unwrapExpression()` instead of accessing this directly.\n */\nexport const EXPRESSION_BRAND: unique symbol = Symbol(\"expression-brand\");\n\n/** Declared symbol type used in the `Expression<T>` interface for branding. */\ndeclare const __expressionBrand: unique symbol;\n\n// ---------------------------------------------------------------------------\n// Public opaque Expression<T> type\n// ---------------------------------------------------------------------------\n\nexport interface ExpressionBrand<out T> {\n  readonly [__expressionBrand]: ExpressionNode<T>;\n}\n\n// Prevents TypeScript from simplifying `Expression<primitive>` down to\n// just `ExpressionBrand<primitive>` — keeps the alias name visible in hovers.\n// Symbol-keyed so it stays hidden from IntelliSense.\ndeclare const __expressionTag: unique symbol;\nexport interface ExpressionTag {\n  readonly [__expressionTag]?: never;\n}\n\n/**\n * An opaque deploy-time expression wrapping type `T`.\n *\n * For object types, properties of `T` are accessible as\n * `Expression<Exclude<T[K], undefined>>`. Expression proxies always expose a\n * symbolic property path, so TypeScript's `undefined` omission marker does not\n * belong in the projected value type. Explicit `null` remains intact.\n * For array types, numeric indices return `Expression<element>` and\n * `.length` is an `Expression<number>`.\n *\n * Function-typed keys on `T` are intentionally NOT surfaced — an\n * `Expression<(...)=>R>` isn't callable at the type level or meaningful\n * at emit time. When bicep-level array/object methods are needed\n * (concat, union, etc.), they are added explicitly via dedicated helper\n * types (e.g. a future `ArrayExpression<T>`), not reflectively derived.\n *\n * `NonNullable<T>` is applied at the input boundary, so\n * `Expression<R | undefined>` yields the same structural surface as\n * `Expression<R>` — otherwise the `| undefined` union would distribute\n * and collapse the object branch into `mapped | {}`, erasing the\n * index signature / member projection.\n */\nexport type Expression<T = unknown> = ExpressionBrand<T> &\n  ExpressionTag &\n  ExpressionShape<NonNullable<T>>;\n\nexport type ExpressionShape<T> = T extends readonly unknown[]\n  ? number extends T[\"length\"]\n    ? {\n        readonly length: Expression<number>;\n        readonly [index: number]: Expression<T[number]>;\n      }\n    : {\n        readonly [K in Exclude<keyof T, keyof any[]>]: Expression<T[K]>;\n      } & {\n        readonly length: Expression<number>;\n        readonly [index: number]: Expression<T[number]>;\n      }\n  : T extends object\n    ? {\n        readonly [K in keyof T as T[K] extends (...a: any[]) => any ? never : K]-?: Expression<\n          Exclude<T[K], undefined>\n        >;\n      }\n    : {};\n\n// ---------------------------------------------------------------------------\n// Input-side types — optional-brand trick\n// ---------------------------------------------------------------------------\n\n/**\n * Carries an *optional* Expression brand on an Input-shaped interface.\n *\n * This is the asymmetric-brand trick that makes the Input type system\n * work without discriminated unions:\n *\n * - Every generated `*Input` interface extends `InputOf<Raw>` and therefore\n *   inherits the optional brand. Plain literal values (e.g. `{ foo: 1 }`)\n *   trivially satisfy it because the brand property is absent, which is\n *   permitted by an optional field.\n * - `Expression<Raw>` carries a *required* brand of the same shape.\n *   Required-fields-satisfy-optional is part of TS structural assignability,\n *   so any `Expression<Raw>` is assignable where an `InputOf<Raw>`\n *   (and thus any `*Input` that extends it) is expected.\n *\n * Net effect: a single `MInput` parameter accepts both literals and\n * whole-subtree `Expression<M>` replacements — no `MInput | Expression<M>`\n * union is needed in the generated signatures. Callers that want to\n * inspect whether a value is a literal or expression use `isExpression()`.\n */\nexport interface InputOf<out Raw> {\n  readonly [__expressionBrand]?: ExpressionNode<Raw>;\n}\n\n/**\n * Writable input form for an array container.\n *\n * Accepts literal `T[]`, another `InputArray<T>`, or `Expression<Raw>`.\n * Deliberately NOT a subtype of `T[]` — passing a CDK-backed array to\n * an API that expects a plain `Array<T>` fails at compile time, which\n * is the correct signal (the value may actually be a Proxy wrapping an\n * `ExpressionNode`, not a real JS array).\n */\nexport interface InputArray<T, Raw = readonly T[]> extends InputOf<Raw> {\n  length: number | Expression<number>;\n  [index: number]: T;\n}\n\n/** Writable input form for a `Record<string, V>` container. */\nexport interface InputRecord<V, Raw = Record<string, V>> extends InputOf<Raw> {\n  [key: string]: V;\n}\n\n/** Writable input form for a fixed-length heterogeneous tuple. */\nexport type InputTuple<\n  T extends readonly unknown[],\n  Raw extends readonly unknown[] = T,\n> = InputOf<Raw> & {\n  length: T[\"length\"] | Expression<number>;\n  [index: number]: T[number] | Expression<Raw[number]>;\n} & {\n  [K in Exclude<keyof T, keyof any[]>]: T[K];\n};\n\n// ---------------------------------------------------------------------------\n// ExpressionOrValue\n// ---------------------------------------------------------------------------\n\n/**\n * Accepts either a plain value `T` or an `Expression<T>` substitution.\n *\n * Use this on scalar/leaf Input sites (primitives, enums, literal-only\n * unions) where a full `InputOf<...>` structural extension doesn't apply.\n * The result is a simple discriminated union; call `isExpression()` to\n * branch on the runtime shape.\n */\nexport type ExpressionOrValue<T> = T | Expression<T>;\n\n// ---------------------------------------------------------------------------\n// Discriminator escape hatch\n// ---------------------------------------------------------------------------\n\n/**\n * Asserts that a deploy-time expression resolves to a specific literal,\n * so it can be used where a discriminator is expected.\n *\n * Discriminator properties on a `@discriminator` model are typed as bare\n * literals (`kind: \"cache\"`) rather than `ExpressionOrValue<\"cache\">`.\n * That is deliberate: TypeScript only treats a property as a discriminant\n * when its type is a *unit* type in every constituent of the union, and a\n * single widened arm disables narrowing for the whole union — completions\n * then offer every variant's properties and excess-property checking\n * degrades to \"allowed if the property exists in any variant\".\n *\n * When the discriminator genuinely isn't known until deployment, wrap the\n * expression with this to state which variant you mean. See the\n * {@link https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/core/provisioning-core#deploy-time-discriminators | deploy-time discriminator example}.\n *\n * Every other property is still fully checked — only the discriminator's\n * type safety is waived. Note that the runtime cannot dispatch on a\n * non-literal discriminator, so serialization falls back to structural\n * variant inference; prefer a literal wherever possible.\n *\n * The literal is inferred from the expression's own type argument. If the\n * expression is loosely typed (`Expression<string>`), name the variant\n * explicitly: `asDiscriminator<\"cache\">(param)`.\n */\nexport function asDiscriminator<L extends string>(value: ExpressionOrValue<L>): L {\n  return value as L;\n}\n\n// ---------------------------------------------------------------------------\n// Unwrap + type guards\n// ---------------------------------------------------------------------------\n\n// Two distinct concepts, two distinct guards:\n//\n//   - `isExpression(x)`     — \"is `x` a typed `Expression<T>` handle\n//                             (the value-level, proxy-backed form)?\"\n//   - `isExpressionNode(x)` — \"is `x` a raw `ExpressionNode` data object\n//                             (one of the AST kinds)?\"\n//\n// These are *disjoint* — a value is either a wrapped Expression handle or a\n// raw AST node, never both. To check the AST kind of either form, narrow\n// via the discriminated `kind` field:\n//\n//   if (isExpression(value)) {\n//     const node = unwrapExpression(value);\n//     if (node.kind === \"fn-call\") { /* node: FunctionCallExpressionNode */ }\n//   }\n//   if (isExpressionNode(value)) {\n//     if (value.kind === \"binary\") { /* value: BinaryExpressionNode */ }\n//   }\n\n/**\n * Extracts the underlying `ExpressionNode` from an `Expression<T>` value.\n *\n * `Expression<T>` is the public, typed handle for a deploy-time expression\n * (backed by a Proxy at runtime); `ExpressionNode` is the raw AST node that\n * the proxy wraps. Use this to walk / inspect / serialize the underlying\n * tree without reaching for the brand symbol directly.\n */\nexport function unwrapExpression<T>(expr: Expression<T>): ExpressionNode<T> {\n  return (expr as unknown as { [EXPRESSION_BRAND]: ExpressionNode<T> })[EXPRESSION_BRAND];\n}\n\n/**\n * Tests whether a value is an `Expression<T>` — the typed, branded handle\n * for a deploy-time expression (proxy-backed). Returns false for raw\n * `ExpressionNode` data; use {@link isExpressionNode} from `./ast-nodes.js`\n * for that.\n */\nexport function isExpression(value: unknown): value is Expression<unknown> {\n  return typeof value === \"object\" && value !== null && EXPRESSION_BRAND in value;\n}\n\n// ---------------------------------------------------------------------------\n// Expression proxy factory\n// ---------------------------------------------------------------------------\n\nexport function wrapExpression<T = unknown>(\n  expression: ExpressionNode,\n  nav?: NavShape,\n): Expression<T> {\n  return new Proxy(Object.create(null) as Expression<T>, {\n    get(_target, prop, _receiver) {\n      if (prop === EXPRESSION_BRAND) {\n        return expression;\n      }\n\n      if (prop === Symbol.toPrimitive || prop === \"toString\") {\n        return () => \"[Expression]\";\n      }\n\n      if (prop === \"valueOf\") {\n        return () => expression;\n      }\n\n      // Avoid being treated as a thenable / Promise\n      if (prop === \"then\") {\n        return undefined;\n      }\n\n      if (typeof prop === \"symbol\") {\n        return undefined;\n      }\n\n      // Numeric string → array access.\n      if (/^\\d+$/u.test(prop)) {\n        const index = Number(prop);\n        const step = navigateShape(nav, index);\n        return wrapExpression(\n          arrayAccessExpressionNode(expression as ExpressionNode, index),\n          step.next,\n        );\n      }\n\n      // String property → property access. Consult the current nav\n      // shape; stamp the access with the wire armPath if an entry\n      // exists, otherwise pass through unchanged. Container navs\n      // (record/array) yield no stamp but still peel a layer.\n      const step = navigateShape(nav, prop);\n      return wrapExpression(\n        propertyAccessExpressionNode(expression as ExpressionNode, prop, {\n          armPath: step.stamp?.armPath,\n        }),\n        step.next,\n      );\n    },\n\n    has(_target, prop) {\n      return prop === EXPRESSION_BRAND;\n    },\n\n    ownKeys() {\n      return [];\n    },\n\n    getOwnPropertyDescriptor(_target, prop) {\n      if (prop === EXPRESSION_BRAND) {\n        return {\n          configurable: true,\n          enumerable: false,\n          value: expression,\n        };\n      }\n      return undefined;\n    },\n  });\n}\n\nexport function wrapExpressionOver<TObject extends object, TValue = unknown>(\n  target: TObject,\n  expression: ExpressionNode,\n): TObject & Expression<TValue> {\n  return new Proxy(target as TObject & Expression<TValue>, {\n    get(backing, prop, receiver) {\n      if (prop === EXPRESSION_BRAND) {\n        return expression;\n      }\n\n      if (prop === Symbol.toPrimitive || prop === \"toString\") {\n        return () => \"[Expression]\";\n      }\n\n      if (prop === \"valueOf\") {\n        return () => expression;\n      }\n\n      if (prop === \"then\") {\n        return undefined;\n      }\n\n      if (Reflect.has(backing, prop)) {\n        return Reflect.get(backing, prop, receiver);\n      }\n\n      if (typeof prop === \"symbol\") {\n        return undefined;\n      }\n\n      if (/^\\d+$/u.test(prop)) {\n        return wrapExpression(\n          arrayAccessExpressionNode(expression as ExpressionNode, Number(prop)),\n        );\n      }\n\n      return wrapExpression(propertyAccessExpressionNode(expression as ExpressionNode, prop));\n    },\n\n    has(backing, prop) {\n      return prop === EXPRESSION_BRAND || Reflect.has(backing, prop);\n    },\n\n    ownKeys(backing) {\n      const keys = Reflect.ownKeys(backing);\n      if (!keys.includes(EXPRESSION_BRAND)) {\n        keys.push(EXPRESSION_BRAND);\n      }\n      return keys;\n    },\n\n    getOwnPropertyDescriptor(backing, prop) {\n      if (prop === EXPRESSION_BRAND) {\n        return {\n          configurable: true,\n          enumerable: false,\n          value: expression,\n        };\n      }\n      return Reflect.getOwnPropertyDescriptor(backing, prop);\n    },\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Proxied-expression factories (return Expression<T>)\n// ---------------------------------------------------------------------------\n\nexport function createBinaryExpression<T>(\n  op: BinaryOperator,\n  left: unknown,\n  right: unknown,\n): Expression<T> {\n  return wrapExpression(binaryExpressionNode(op, left, right));\n}\n\nexport function createUnaryExpression<T>(op: UnaryOperator, argument: unknown): Expression<T> {\n  return wrapExpression(unaryExpressionNode(op, argument));\n}\n\nexport function createTernaryExpression<T>(\n  condition: unknown,\n  trueValue: unknown,\n  falseValue: unknown,\n): Expression<T> {\n  return wrapExpression(ternaryExpressionNode(condition, trueValue, falseValue));\n}\n\nexport function createFunctionCallExpression<T>(name: string, args: unknown[]): Expression<T> {\n  return wrapExpression(functionCallExpressionNode(name, args));\n}\n"]}

package/dist/browser/expression/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/expression/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,GAAG,kBAAkB,GAAG,SAAS,GACrD,WAAW,GAAG,SAAS,CAoBzB"}

package/dist/browser/expression/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/expression/utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAKlC,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CACpC,KAAsD;IAEtD,MAAM,MAAM,GACV,KAAK,EAAE,IAAI,KAAK,eAAe;QAC7B,CAAC,CAAC,KAAK,CAAC,MAAM;QACd,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,SAAS;YACzB,CAAC,CAAC,KAAK,CAAC,QAAQ;YAChB,CAAC,CAAC,SAAS,CAAC;IAClB,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACjD,QAAQ,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;QACrC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,iBAAiB;YACpB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC;QACxB,KAAK,eAAe;YAClB,OAAO,eAAe,CAAC;QACzB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ExpressionNode, TargetScope } from \"../serialization/ast/index.js\";\nimport type { ExpressionNode as CoreExpressionNode } from \"./ast-nodes.js\";\n\n/** Identifies the standard scope functions without evaluating their arguments. */\nexport function getScopeFunctionTarget(\n  scope: ExpressionNode | CoreExpressionNode | undefined,\n): TargetScope | undefined {\n  const target =\n    scope?.kind === \"function-call\"\n      ? scope.target\n      : scope?.kind === \"fn-call\"\n        ? scope.operator\n        : undefined;\n  if (typeof target !== \"string\") return undefined;\n  switch (target.replace(/^az\\./u, \"\")) {\n    case \"tenant\":\n      return \"tenant\";\n    case \"managementGroup\":\n      return \"managementGroup\";\n    case \"subscription\":\n      return \"subscription\";\n    case \"resourceGroup\":\n      return \"resourceGroup\";\n    default:\n      return undefined;\n  }\n}\n"]}