@azure/provisioning-core 1.0.0-beta.1 → 1.0.0-beta.2

package/dist/esm/serialization/ast/resource-utils.js

@@ -0,0 +1,52 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+/** Transforms a resource's object body while preserving conditions and loops. */
+export function updateResourceBody(body, transform) {
+    switch (body.kind) {
+        case "object":
+            return transform(body);
+        case "if-condition":
+        case "for-expression": {
+            if (body.body.kind !== "object" &&
+                body.body.kind !== "if-condition" &&
+                body.body.kind !== "for-expression") {
+                throw new Error(`Invalid resource body "${body.body.kind}".`);
+            }
+            return { ...body, body: updateResourceBody(body.body, transform) };
+        }
+    }
+}
+/** Gets the object body beneath a resource's condition and loop wrappers. */
+export function getResourceBody(body) {
+    if (body.kind === "object")
+        return body;
+    if (body.body.kind !== "object" &&
+        body.body.kind !== "if-condition" &&
+        body.body.kind !== "for-expression") {
+        throw new Error(`Invalid resource body "${body.body.kind}".`);
+    }
+    return getResourceBody(body.body);
+}
+/** Removes the scope field without changing other resource declaration data. */
+export function removeResourceScope(resource) {
+    return {
+        ...resource,
+        value: updateResourceBody(resource.value, (body) => {
+            const { scope: _scope, ...rest } = body.value;
+            return { ...body, value: rest };
+        }),
+    };
+}
+/** Gets the parent declaration identifier, including indexed parent accesses. */
+export function getResourceArmParentIdentifier(resource) {
+    const parent = getResourceBody(resource.value).value.parent;
+    if (parent === undefined)
+        return undefined;
+    if (parent.kind === "identifier")
+        return parent.id;
+    if (parent.kind === "array-access" && parent.base.kind === "identifier") {
+        return parent.base.id;
+    }
+    throw new Error(`Unsupported ARM parent expression for "${resource.bicepIdentifier}".`);
+}
+//# sourceMappingURL=resource-utils.js.map

package/dist/esm/serialization/ast/resource-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.js","sourceRoot":"","sources":["../../../../src/serialization/ast/resource-utils.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAIlC,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAChC,IAAwB,EACxB,SAA8C;IAE9C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,cAAc,CAAC;QACpB,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IACE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc;gBACjC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,EACnC,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxC,IACE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,EACnC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,QAAiC;IACnE,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACjD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAC9C,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAClC,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,8BAA8B,CAC5C,QAAiC;IAEjC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACxE,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0CAA0C,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { DeclarableBodyNode, ObjectValue, ResourceDeclarationNode } from \"./index.js\";\n\n/** Transforms a resource's object body while preserving conditions and loops. */\nexport function updateResourceBody(\n  body: DeclarableBodyNode,\n  transform: (value: ObjectValue) => ObjectValue,\n): DeclarableBodyNode {\n  switch (body.kind) {\n    case \"object\":\n      return transform(body);\n    case \"if-condition\":\n    case \"for-expression\": {\n      if (\n        body.body.kind !== \"object\" &&\n        body.body.kind !== \"if-condition\" &&\n        body.body.kind !== \"for-expression\"\n      ) {\n        throw new Error(`Invalid resource body \"${body.body.kind}\".`);\n      }\n      return { ...body, body: updateResourceBody(body.body, transform) };\n    }\n  }\n}\n\n/** Gets the object body beneath a resource's condition and loop wrappers. */\nexport function getResourceBody(body: DeclarableBodyNode): ObjectValue {\n  if (body.kind === \"object\") return body;\n  if (\n    body.body.kind !== \"object\" &&\n    body.body.kind !== \"if-condition\" &&\n    body.body.kind !== \"for-expression\"\n  ) {\n    throw new Error(`Invalid resource body \"${body.body.kind}\".`);\n  }\n  return getResourceBody(body.body);\n}\n\n/** Removes the scope field without changing other resource declaration data. */\nexport function removeResourceScope(resource: ResourceDeclarationNode): ResourceDeclarationNode {\n  return {\n    ...resource,\n    value: updateResourceBody(resource.value, (body) => {\n      const { scope: _scope, ...rest } = body.value;\n      return { ...body, value: rest };\n    }),\n  };\n}\n\n/** Gets the parent declaration identifier, including indexed parent accesses. */\nexport function getResourceArmParentIdentifier(\n  resource: ResourceDeclarationNode,\n): string | undefined {\n  const parent = getResourceBody(resource.value).value.parent;\n  if (parent === undefined) return undefined;\n  if (parent.kind === \"identifier\") return parent.id;\n  if (parent.kind === \"array-access\" && parent.base.kind === \"identifier\") {\n    return parent.base.id;\n  }\n  throw new Error(`Unsupported ARM parent expression for \"${resource.bicepIdentifier}\".`);\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/authored-context.d.ts

@@ -0,0 +1,12 @@
+import type { Stack } from "../../../constructs/stack.js";
+import type { ResourceDeclaration } from "../../../constructs/resource/resource.js";
+import type { DeclarationSymbolMap } from "../../symbol-map.js";
+export interface AuthoredResourceContext {
+    /** Nearest authored resource ancestor, including resource groups. */
+    readonly authoredParent: string | undefined;
+    /** Existing-explicit lookups affect placement; pass-through-explicit scopes only affect emitted bodies. */
+    readonly scopeOrigin: "existing-explicit" | "pass-through-explicit" | "resourceGroup" | "none";
+}
+export declare function validateResourceAncestry(stack: Stack, resources: readonly ResourceDeclaration[]): void;
+export declare function collectAuthoredResourceContexts(resources: readonly ResourceDeclaration[], symbols: DeclarationSymbolMap): ReadonlyMap<string, AuthoredResourceContext>;
+//# sourceMappingURL=authored-context.d.ts.map

package/dist/esm/serialization/bicep/file-layout/authored-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-context.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/authored-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAMpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,2GAA2G;IAC3G,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,uBAAuB,GAAG,eAAe,GAAG,MAAM,CAAC;CAChG;AAWD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,mBAAmB,EAAE,GACxC,IAAI,CAcN;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,OAAO,EAAE,oBAAoB,GAC5B,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,CA4B9C"}

package/dist/esm/serialization/bicep/file-layout/authored-context.js

@@ -0,0 +1,57 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { isResourceDeclaration } from "../../../constructs/resource/resource-utils.js";
+import { getArmParent, getResourceGroupAncestor, getResourceScope, } from "../../../constructs/resource/resource-relationships.js";
+import { getScopeFunctionTarget } from "../../../expression/utils.js";
+/** Distinguishes pass-through declaration data from supported existing lookups. */
+function usesPassThroughExplicitScope(resource) {
+    const scope = getResourceScope(resource);
+    return (scope !== undefined &&
+        (resource.existing !== true || getScopeFunctionTarget(scope) === undefined));
+}
+export function validateResourceAncestry(stack, resources) {
+    const resourceSet = new Set(resources);
+    for (const resource of resources) {
+        const ancestors = new Set([resource.self]);
+        for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {
+            if (ancestors.has(parent.self)) {
+                throw new Error(`Cyclic resource attachment in Stack "${stack.name}".`);
+            }
+            ancestors.add(parent.self);
+            if (isResourceDeclaration(parent) && !resourceSet.has(parent.self)) {
+                throw new Error(`Resource "${resource.type}" has a parent outside Stack "${stack.name}".`);
+            }
+        }
+    }
+}
+export function collectAuthoredResourceContexts(resources, symbols) {
+    const resourceContexts = new Map();
+    for (const resource of resources) {
+        const identifier = symbols.get(resource);
+        if (identifier === undefined) {
+            throw new Error(`Missing symbol for resource type "${resource.type}".`);
+        }
+        let authoredParent;
+        for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {
+            if (!isResourceDeclaration(parent))
+                continue;
+            authoredParent = symbols.get(parent.self);
+            if (authoredParent === undefined) {
+                throw new Error(`Missing authored parent symbol for resource "${identifier}".`);
+            }
+            break;
+        }
+        resourceContexts.set(identifier, {
+            authoredParent,
+            scopeOrigin: usesPassThroughExplicitScope(resource)
+                ? "pass-through-explicit"
+                : getResourceScope(resource) !== undefined
+                    ? "existing-explicit"
+                    : getArmParent(resource) === undefined && getResourceGroupAncestor(resource) !== undefined
+                        ? "resourceGroup"
+                        : "none",
+        });
+    }
+    return resourceContexts;
+}
+//# sourceMappingURL=authored-context.js.map

package/dist/esm/serialization/bicep/file-layout/authored-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-context.js","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/authored-context.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAIvF,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,wDAAwD,CAAC;AAEhE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAStE,mFAAmF;AACnF,SAAS,4BAA4B,CAAC,QAA6B;IACjE,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI,IAAI,sBAAsB,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAY,EACZ,SAAyC;IAEzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,KAAK,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAChF,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YAC1E,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,iCAAiC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,SAAyC,EACzC,OAA6B;IAE7B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAmC,CAAC;IACpE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,cAAkC,CAAC;QACvC,KAAK,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAChF,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC;gBAAE,SAAS;YAC7C,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,gDAAgD,UAAU,IAAI,CAAC,CAAC;YAClF,CAAC;YACD,MAAM;QACR,CAAC;QACD,gBAAgB,CAAC,GAAG,CAAC,UAAU,EAAE;YAC/B,cAAc;YACd,WAAW,EAAE,4BAA4B,CAAC,QAAQ,CAAC;gBACjD,CAAC,CAAC,uBAAuB;gBACzB,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,SAAS;oBACxC,CAAC,CAAC,mBAAmB;oBACrB,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,wBAAwB,CAAC,QAAQ,CAAC,KAAK,SAAS;wBACxF,CAAC,CAAC,eAAe;wBACjB,CAAC,CAAC,MAAM;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { isResourceDeclaration } from \"../../../constructs/resource/resource-utils.js\";\nimport type { Stack } from \"../../../constructs/stack.js\";\nimport type { ProvisioningComponent } from \"../../../constructs/provisioning-component.js\";\nimport type { ResourceDeclaration } from \"../../../constructs/resource/resource.js\";\nimport {\n  getArmParent,\n  getResourceGroupAncestor,\n  getResourceScope,\n} from \"../../../constructs/resource/resource-relationships.js\";\nimport type { DeclarationSymbolMap } from \"../../symbol-map.js\";\nimport { getScopeFunctionTarget } from \"../../../expression/utils.js\";\n\nexport interface AuthoredResourceContext {\n  /** Nearest authored resource ancestor, including resource groups. */\n  readonly authoredParent: string | undefined;\n  /** Existing-explicit lookups affect placement; pass-through-explicit scopes only affect emitted bodies. */\n  readonly scopeOrigin: \"existing-explicit\" | \"pass-through-explicit\" | \"resourceGroup\" | \"none\";\n}\n\n/** Distinguishes pass-through declaration data from supported existing lookups. */\nfunction usesPassThroughExplicitScope(resource: ResourceDeclaration): boolean {\n  const scope = getResourceScope(resource);\n  return (\n    scope !== undefined &&\n    (resource.existing !== true || getScopeFunctionTarget(scope) === undefined)\n  );\n}\n\nexport function validateResourceAncestry(\n  stack: Stack,\n  resources: readonly ResourceDeclaration[],\n): void {\n  const resourceSet = new Set(resources);\n  for (const resource of resources) {\n    const ancestors = new Set<ProvisioningComponent>([resource.self]);\n    for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {\n      if (ancestors.has(parent.self)) {\n        throw new Error(`Cyclic resource attachment in Stack \"${stack.name}\".`);\n      }\n      ancestors.add(parent.self);\n      if (isResourceDeclaration(parent) && !resourceSet.has(parent.self)) {\n        throw new Error(`Resource \"${resource.type}\" has a parent outside Stack \"${stack.name}\".`);\n      }\n    }\n  }\n}\n\nexport function collectAuthoredResourceContexts(\n  resources: readonly ResourceDeclaration[],\n  symbols: DeclarationSymbolMap,\n): ReadonlyMap<string, AuthoredResourceContext> {\n  const resourceContexts = new Map<string, AuthoredResourceContext>();\n  for (const resource of resources) {\n    const identifier = symbols.get(resource);\n    if (identifier === undefined) {\n      throw new Error(`Missing symbol for resource type \"${resource.type}\".`);\n    }\n    let authoredParent: string | undefined;\n    for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {\n      if (!isResourceDeclaration(parent)) continue;\n      authoredParent = symbols.get(parent.self);\n      if (authoredParent === undefined) {\n        throw new Error(`Missing authored parent symbol for resource \"${identifier}\".`);\n      }\n      break;\n    }\n    resourceContexts.set(identifier, {\n      authoredParent,\n      scopeOrigin: usesPassThroughExplicitScope(resource)\n        ? \"pass-through-explicit\"\n        : getResourceScope(resource) !== undefined\n          ? \"existing-explicit\"\n          : getArmParent(resource) === undefined && getResourceGroupAncestor(resource) !== undefined\n            ? \"resourceGroup\"\n            : \"none\",\n    });\n  }\n  return resourceContexts;\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/bicep-namer.d.ts

@@ -0,0 +1,11 @@
+import type { ExpressionReference } from "../../ast/expression-rewriter.js";
+import type { BicepAst } from "./file-preparation.js";
+export declare const RESOURCE_NAME_OVERRIDES: ReadonlyMap<string, string>;
+export declare class BicepNamer {
+    #private;
+    constructor(ast: BicepAst);
+    moduleName(rootIdentifier: string, fileName: string): string;
+    parameterName(reference: ExpressionReference): string;
+    outputName(reference: ExpressionReference, preferredName?: string): string;
+}
+//# sourceMappingURL=bicep-namer.d.ts.map

package/dist/esm/serialization/bicep/file-layout/bicep-namer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bicep-namer.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/bicep-namer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAW9D,CAAC;AAuBH,qBAAa,UAAU;;gBAIT,GAAG,EAAE,QAAQ;IAczB,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ5D,aAAa,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM;IAIrD,UAAU,CACR,SAAS,EAAE,mBAAmB,EAC9B,aAAa,GAAE,MAAqC,GACnD,MAAM;CAGV"}

package/dist/esm/serialization/bicep/file-layout/bicep-namer.js

@@ -0,0 +1,100 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { sanitizeIdentifier } from "../../identifiers.js";
+import { walkDeclarationExpressions } from "../../ast/expression-walker.js";
+// Deliberately limited to built-in names likely to collide with resource symbols.
+export const RESOURCE_NAME_OVERRIDES = new Map([
+    ["resourceGroup", "rg"],
+    ["subscription", "subscriptionResource"],
+    ["managementGroup", "managementGroupResource"],
+    ["tenant", "tenantResource"],
+    ["deployment", "deploymentResource"],
+    ["environment", "environmentResource"],
+    ["reference", "referenceResource"],
+    ["guid", "guidResource"],
+    ["format", "formatResource"],
+    ["range", "rangeResource"],
+]);
+function collectLoopBindings(ast) {
+    const loopBindings = new Set();
+    for (const declaration of [
+        ...ast.resources.values(),
+        ...ast.parameters.values(),
+        ...ast.variables.values(),
+        ...ast.outputs.values(),
+        ...ast.modules.values(),
+    ]) {
+        walkDeclarationExpressions(declaration, (node) => {
+            if (node.kind === "for-expression") {
+                loopBindings.add(node.itemVariable);
+                if (node.indexVariable !== undefined) {
+                    loopBindings.add(node.indexVariable);
+                }
+            }
+        });
+    }
+    return loopBindings;
+}
+export class BicepNamer {
+    #usedNames;
+    #usedOutputNames = new Set();
+    constructor(ast) {
+        this.#usedNames = new Set([...RESOURCE_NAME_OVERRIDES.keys(), ...collectLoopBindings(ast)].map((name) => name.toLowerCase()));
+        for (const declarations of [ast.parameters, ast.variables, ast.resources, ast.modules]) {
+            for (const declaration of declarations.values()) {
+                this.#usedNames.add(declaration.bicepIdentifier.toLowerCase());
+            }
+        }
+        for (const name of ast.outputs.keys())
+            this.#usedOutputNames.add(name.toLowerCase());
+    }
+    moduleName(rootIdentifier, fileName) {
+        return createUniqueName(`${rootIdentifier}Module`, sanitizeIdentifier(fileName.replace(/\.bicep$/u, ""), "file"), this.#usedNames);
+    }
+    parameterName(reference) {
+        return createUniqueName(buildRefParamName(reference), reference.identifier, this.#usedNames);
+    }
+    outputName(reference, preferredName = buildRefParamName(reference)) {
+        return createUniqueName(preferredName, reference.identifier, this.#usedOutputNames);
+    }
+}
+function buildRefParamName(reference) {
+    const segments = reference.path.map((segment) => {
+        if (typeof segment === "number")
+            return String(segment);
+        const name = sanitizeIdentifier(segment);
+        return name.charAt(0).toUpperCase() + name.slice(1);
+    });
+    let modifiers = "";
+    let current = reference.expression;
+    let depth = 0;
+    while (current.kind === "property-access" || current.kind === "array-access") {
+        if (current.nullish)
+            modifiers += `Safe${depth}`;
+        if (current.kind === "array-access" && current.fromEnd) {
+            modifiers += `FromEnd${depth}`;
+        }
+        current = current.base;
+        depth++;
+    }
+    return reference.identifier + segments.join("") + modifiers;
+}
+function createUniqueName(name, alias, usedNames) {
+    if (!usedNames.has(name.toLowerCase())) {
+        usedNames.add(name.toLowerCase());
+        return name;
+    }
+    const stem = `${alias}${name.charAt(0).toUpperCase()}${name.slice(1)}`;
+    if (!usedNames.has(stem.toLowerCase())) {
+        usedNames.add(stem.toLowerCase());
+        return stem;
+    }
+    let counter = 2;
+    while (usedNames.has(`${stem}${counter}`.toLowerCase())) {
+        counter += 1;
+    }
+    const uniqueName = `${stem}${counter}`;
+    usedNames.add(uniqueName.toLowerCase());
+    return uniqueName;
+}
+//# sourceMappingURL=bicep-namer.js.map

package/dist/esm/serialization/bicep/file-layout/bicep-namer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bicep-namer.js","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/bicep-namer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { sanitizeIdentifier } from \"../../identifiers.js\";\nimport { walkDeclarationExpressions } from \"../../ast/expression-walker.js\";\nimport type { ExpressionReference } from \"../../ast/expression-rewriter.js\";\nimport type { BicepAst } from \"./file-preparation.js\";\n\n// Deliberately limited to built-in names likely to collide with resource symbols.\nexport const RESOURCE_NAME_OVERRIDES: ReadonlyMap<string, string> = new Map([\n  [\"resourceGroup\", \"rg\"],\n  [\"subscription\", \"subscriptionResource\"],\n  [\"managementGroup\", \"managementGroupResource\"],\n  [\"tenant\", \"tenantResource\"],\n  [\"deployment\", \"deploymentResource\"],\n  [\"environment\", \"environmentResource\"],\n  [\"reference\", \"referenceResource\"],\n  [\"guid\", \"guidResource\"],\n  [\"format\", \"formatResource\"],\n  [\"range\", \"rangeResource\"],\n]);\n\nfunction collectLoopBindings(ast: BicepAst): ReadonlySet<string> {\n  const loopBindings = new Set<string>();\n  for (const declaration of [\n    ...ast.resources.values(),\n    ...ast.parameters.values(),\n    ...ast.variables.values(),\n    ...ast.outputs.values(),\n    ...ast.modules.values(),\n  ]) {\n    walkDeclarationExpressions(declaration, (node) => {\n      if (node.kind === \"for-expression\") {\n        loopBindings.add(node.itemVariable);\n        if (node.indexVariable !== undefined) {\n          loopBindings.add(node.indexVariable);\n        }\n      }\n    });\n  }\n  return loopBindings;\n}\n\nexport class BicepNamer {\n  readonly #usedNames: Set<string>;\n  readonly #usedOutputNames = new Set<string>();\n\n  constructor(ast: BicepAst) {\n    this.#usedNames = new Set(\n      [...RESOURCE_NAME_OVERRIDES.keys(), ...collectLoopBindings(ast)].map((name) =>\n        name.toLowerCase(),\n      ),\n    );\n    for (const declarations of [ast.parameters, ast.variables, ast.resources, ast.modules]) {\n      for (const declaration of declarations.values()) {\n        this.#usedNames.add(declaration.bicepIdentifier.toLowerCase());\n      }\n    }\n    for (const name of ast.outputs.keys()) this.#usedOutputNames.add(name.toLowerCase());\n  }\n\n  moduleName(rootIdentifier: string, fileName: string): string {\n    return createUniqueName(\n      `${rootIdentifier}Module`,\n      sanitizeIdentifier(fileName.replace(/\\.bicep$/u, \"\"), \"file\"),\n      this.#usedNames,\n    );\n  }\n\n  parameterName(reference: ExpressionReference): string {\n    return createUniqueName(buildRefParamName(reference), reference.identifier, this.#usedNames);\n  }\n\n  outputName(\n    reference: ExpressionReference,\n    preferredName: string = buildRefParamName(reference),\n  ): string {\n    return createUniqueName(preferredName, reference.identifier, this.#usedOutputNames);\n  }\n}\n\nfunction buildRefParamName(reference: ExpressionReference): string {\n  const segments = reference.path.map((segment) => {\n    if (typeof segment === \"number\") return String(segment);\n    const name = sanitizeIdentifier(segment);\n    return name.charAt(0).toUpperCase() + name.slice(1);\n  });\n  let modifiers = \"\";\n  let current = reference.expression;\n  let depth = 0;\n  while (current.kind === \"property-access\" || current.kind === \"array-access\") {\n    if (current.nullish) modifiers += `Safe${depth}`;\n    if (current.kind === \"array-access\" && current.fromEnd) {\n      modifiers += `FromEnd${depth}`;\n    }\n    current = current.base;\n    depth++;\n  }\n  return reference.identifier + segments.join(\"\") + modifiers;\n}\n\nfunction createUniqueName(name: string, alias: string, usedNames: Set<string>): string {\n  if (!usedNames.has(name.toLowerCase())) {\n    usedNames.add(name.toLowerCase());\n    return name;\n  }\n\n  const stem = `${alias}${name.charAt(0).toUpperCase()}${name.slice(1)}`;\n\n  if (!usedNames.has(stem.toLowerCase())) {\n    usedNames.add(stem.toLowerCase());\n    return stem;\n  }\n\n  let counter = 2;\n  while (usedNames.has(`${stem}${counter}`.toLowerCase())) {\n    counter += 1;\n  }\n\n  const uniqueName = `${stem}${counter}`;\n\n  usedNames.add(uniqueName.toLowerCase());\n  return uniqueName;\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/build-bicep-files.d.ts

@@ -0,0 +1,7 @@
+import type { Stack } from "../../../constructs/stack.js";
+import type { InfraNode } from "../../ast/index.js";
+import { type PreparedBicepFile } from "./file-preparation.js";
+export declare function toInfraNode(file: PreparedBicepFile): InfraNode;
+/** Builds enriched declaration ASTs, then plans and wires deployment files. */
+export declare function buildBicepFiles(stack: Stack): readonly InfraNode[];
+//# sourceMappingURL=build-bicep-files.d.ts.map

package/dist/esm/serialization/bicep/file-layout/build-bicep-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-bicep-files.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/build-bicep-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAI1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAG/B,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,CAW9D;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,SAAS,EAAE,CAqBlE"}

package/dist/esm/serialization/bicep/file-layout/build-bicep-files.js

@@ -0,0 +1,46 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { collectResourceDeclarations } from "../../../constructs/resource/resource-query.js";
+import { buildStackDeclarations } from "../../ast/declaration-builder.js";
+import { createSymbolMap } from "../../symbol-map.js";
+import { collectAuthoredResourceContexts, validateResourceAncestry } from "./authored-context.js";
+import { planDeploymentFiles } from "./deployment-planning.js";
+import { BicepNamer, RESOURCE_NAME_OVERRIDES } from "./bicep-namer.js";
+import { prepareDeploymentFiles, } from "./file-preparation.js";
+import { wireDeploymentFiles } from "./reference-wiring.js";
+export function toInfraNode(file) {
+    const { ast } = file;
+    return {
+        fileName: file.fileName,
+        targetScope: file.targetScope,
+        ...(ast.resources.size === 0 ? {} : { resources: Object.fromEntries(ast.resources) }),
+        ...(ast.parameters.size === 0 ? {} : { parameters: Object.fromEntries(ast.parameters) }),
+        ...(ast.variables.size === 0 ? {} : { variables: Object.fromEntries(ast.variables) }),
+        ...(ast.outputs.size === 0 ? {} : { outputs: Object.fromEntries(ast.outputs) }),
+        ...(ast.modules.size === 0 ? {} : { modules: Object.fromEntries(ast.modules) }),
+    };
+}
+/** Builds enriched declaration ASTs, then plans and wires deployment files. */
+export function buildBicepFiles(stack) {
+    const resources = collectResourceDeclarations(stack);
+    validateResourceAncestry(stack, resources);
+    const symbols = createSymbolMap(resources, stack, RESOURCE_NAME_OVERRIDES);
+    const declarations = buildStackDeclarations(stack, resources, symbols);
+    const stackAst = {
+        targetScope: stack.targetScope,
+        resources: new Map(Object.entries(declarations.resources ?? {})),
+        parameters: new Map(Object.entries(declarations.parameters ?? {})),
+        variables: new Map(Object.entries(declarations.variables ?? {})),
+        outputs: new Map(Object.entries(declarations.outputs ?? {})),
+        modules: new Map(),
+    };
+    const namer = new BicepNamer(stackAst);
+    const resourceContexts = collectAuthoredResourceContexts(resources, symbols);
+    const layout = planDeploymentFiles(stackAst, resourceContexts);
+    const prepared = prepareDeploymentFiles(stack.name, stackAst, resourceContexts, layout, namer);
+    if (prepared.modules.length > 0) {
+        wireDeploymentFiles(stack.name, prepared);
+    }
+    return [toInfraNode(prepared.entry), ...prepared.modules.map(({ file }) => toInfraNode(file))];
+}
+//# sourceMappingURL=build-bicep-files.js.map

package/dist/esm/serialization/bicep/file-layout/build-bicep-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-bicep-files.js","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/build-bicep-files.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { Stack } from \"../../../constructs/stack.js\";\nimport { collectResourceDeclarations } from \"../../../constructs/resource/resource-query.js\";\nimport { buildStackDeclarations } from \"../../ast/declaration-builder.js\";\nimport { createSymbolMap } from \"../../symbol-map.js\";\nimport type { InfraNode } from \"../../ast/index.js\";\nimport { collectAuthoredResourceContexts, validateResourceAncestry } from \"./authored-context.js\";\nimport { planDeploymentFiles } from \"./deployment-planning.js\";\nimport { BicepNamer, RESOURCE_NAME_OVERRIDES } from \"./bicep-namer.js\";\nimport {\n  prepareDeploymentFiles,\n  type BicepAst,\n  type PreparedBicepFile,\n} from \"./file-preparation.js\";\nimport { wireDeploymentFiles } from \"./reference-wiring.js\";\n\nexport function toInfraNode(file: PreparedBicepFile): InfraNode {\n  const { ast } = file;\n  return {\n    fileName: file.fileName,\n    targetScope: file.targetScope,\n    ...(ast.resources.size === 0 ? {} : { resources: Object.fromEntries(ast.resources) }),\n    ...(ast.parameters.size === 0 ? {} : { parameters: Object.fromEntries(ast.parameters) }),\n    ...(ast.variables.size === 0 ? {} : { variables: Object.fromEntries(ast.variables) }),\n    ...(ast.outputs.size === 0 ? {} : { outputs: Object.fromEntries(ast.outputs) }),\n    ...(ast.modules.size === 0 ? {} : { modules: Object.fromEntries(ast.modules) }),\n  };\n}\n\n/** Builds enriched declaration ASTs, then plans and wires deployment files. */\nexport function buildBicepFiles(stack: Stack): readonly InfraNode[] {\n  const resources = collectResourceDeclarations(stack);\n  validateResourceAncestry(stack, resources);\n  const symbols = createSymbolMap(resources, stack, RESOURCE_NAME_OVERRIDES);\n  const declarations = buildStackDeclarations(stack, resources, symbols);\n  const stackAst: BicepAst = {\n    targetScope: stack.targetScope,\n    resources: new Map(Object.entries(declarations.resources ?? {})),\n    parameters: new Map(Object.entries(declarations.parameters ?? {})),\n    variables: new Map(Object.entries(declarations.variables ?? {})),\n    outputs: new Map(Object.entries(declarations.outputs ?? {})),\n    modules: new Map(),\n  };\n  const namer = new BicepNamer(stackAst);\n  const resourceContexts = collectAuthoredResourceContexts(resources, symbols);\n  const layout = planDeploymentFiles(stackAst, resourceContexts);\n  const prepared = prepareDeploymentFiles(stack.name, stackAst, resourceContexts, layout, namer);\n  if (prepared.modules.length > 0) {\n    wireDeploymentFiles(stack.name, prepared);\n  }\n  return [toInfraNode(prepared.entry), ...prepared.modules.map(({ file }) => toInfraNode(file))];\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/deployment-planning.d.ts

@@ -0,0 +1,19 @@
+import type { ExpressionNode, TargetScope } from "../../ast/index.js";
+import type { AuthoredResourceContext } from "./authored-context.js";
+import type { BicepAst } from "./file-preparation.js";
+export interface DeploymentFilePlan {
+    readonly boundary: string | undefined;
+    readonly resources: Set<string>;
+    readonly authoredResourceGroup: string | undefined;
+    readonly moduleScope: ExpressionNode | undefined;
+    readonly targetScope: TargetScope;
+}
+export interface DeploymentLayout {
+    readonly entryPlan: DeploymentFilePlan;
+    readonly deployments: readonly DeploymentFilePlan[];
+    readonly pureExistingResources: ReadonlySet<string>;
+    readonly existingResourceToAuthoredResourceGroup: ReadonlyMap<string, string | undefined>;
+    readonly existingResourcesWithExplicitScope: ReadonlySet<string>;
+}
+export declare function planDeploymentFiles(stackAst: BicepAst, authoredContexts: ReadonlyMap<string, AuthoredResourceContext>): DeploymentLayout;
+//# sourceMappingURL=deployment-planning.d.ts.map

package/dist/esm/serialization/bicep/file-layout/deployment-planning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-planning.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/deployment-planning.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,cAAc,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,uCAAuC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1F,QAAQ,CAAC,kCAAkC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC7D,gBAAgB,CAmElB"}

package/dist/esm/serialization/bicep/file-layout/deployment-planning.js

@@ -0,0 +1,68 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ResourceGroup } from "../../../constructs/built-in-resources/resource-group.js";
+import { getResourceBody } from "../../ast/resource-utils.js";
+import { groupArmResourcesByRoot, getTargetScope } from "./deployment-resource-utils.js";
+export function planDeploymentFiles(stackAst, authoredContexts) {
+    const entryPlan = {
+        boundary: undefined,
+        resources: new Set(),
+        authoredResourceGroup: undefined,
+        moduleScope: undefined,
+        targetScope: stackAst.targetScope,
+    };
+    const armResourcesByRoot = groupArmResourcesByRoot(stackAst.resources, authoredContexts);
+    const deployments = [];
+    const pureExistingResources = new Set();
+    const existingResourceToAuthoredResourceGroup = new Map();
+    const existingResourcesWithExplicitScope = new Set();
+    for (const [root, treeResources] of armResourcesByRoot) {
+        const resource = stackAst.resources.get(root);
+        const rootContext = authoredContexts.get(root);
+        const authoredResourceGroup = rootContext.authoredParent;
+        const moduleScope = rootContext.scopeOrigin === "pass-through-explicit"
+            ? authoredResourceGroup === undefined
+                ? undefined
+                : { kind: "identifier", id: authoredResourceGroup }
+            : getResourceBody(resource.value).value.scope;
+        if (resource.type === ResourceGroup.resourceType ||
+            (stackAst.targetScope === "subscription" && moduleScope === undefined)) {
+            for (const name of treeResources)
+                entryPlan.resources.add(name);
+        }
+        else if ([...treeResources].every((name) => stackAst.resources.get(name).existing)) {
+            for (const name of treeResources) {
+                pureExistingResources.add(name);
+                existingResourceToAuthoredResourceGroup.set(name, authoredResourceGroup);
+                for (let ancestor = name; ancestor !== undefined && ancestor !== authoredResourceGroup; ancestor = authoredContexts.get(ancestor).authoredParent) {
+                    const origin = authoredContexts.get(ancestor).scopeOrigin;
+                    if (origin === "existing-explicit" || origin === "pass-through-explicit") {
+                        existingResourcesWithExplicitScope.add(name);
+                        break;
+                    }
+                }
+            }
+        }
+        else {
+            deployments.push({
+                boundary: root,
+                resources: treeResources,
+                authoredResourceGroup,
+                moduleScope,
+                targetScope: rootContext.scopeOrigin === "resourceGroup" ||
+                    (rootContext.scopeOrigin === "pass-through-explicit" &&
+                        authoredResourceGroup !== undefined)
+                    ? "resourceGroup"
+                    : getTargetScope(moduleScope, stackAst.targetScope),
+            });
+        }
+    }
+    return {
+        entryPlan,
+        deployments,
+        pureExistingResources,
+        existingResourceToAuthoredResourceGroup,
+        existingResourcesWithExplicitScope,
+    };
+}
+//# sourceMappingURL=deployment-planning.js.map

package/dist/esm/serialization/bicep/file-layout/deployment-planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-planning.js","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/deployment-planning.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { ResourceGroup } from \"../../../constructs/built-in-resources/resource-group.js\";\nimport type { ExpressionNode, TargetScope } from \"../../ast/index.js\";\nimport { getResourceBody } from \"../../ast/resource-utils.js\";\nimport type { AuthoredResourceContext } from \"./authored-context.js\";\nimport { groupArmResourcesByRoot, getTargetScope } from \"./deployment-resource-utils.js\";\nimport type { BicepAst } from \"./file-preparation.js\";\n\nexport interface DeploymentFilePlan {\n  readonly boundary: string | undefined;\n  readonly resources: Set<string>;\n  readonly authoredResourceGroup: string | undefined;\n  readonly moduleScope: ExpressionNode | undefined;\n  readonly targetScope: TargetScope;\n}\n\nexport interface DeploymentLayout {\n  readonly entryPlan: DeploymentFilePlan;\n  readonly deployments: readonly DeploymentFilePlan[];\n  readonly pureExistingResources: ReadonlySet<string>;\n  readonly existingResourceToAuthoredResourceGroup: ReadonlyMap<string, string | undefined>;\n  readonly existingResourcesWithExplicitScope: ReadonlySet<string>;\n}\n\nexport function planDeploymentFiles(\n  stackAst: BicepAst,\n  authoredContexts: ReadonlyMap<string, AuthoredResourceContext>,\n): DeploymentLayout {\n  const entryPlan: DeploymentFilePlan = {\n    boundary: undefined,\n    resources: new Set(),\n    authoredResourceGroup: undefined,\n    moduleScope: undefined,\n    targetScope: stackAst.targetScope,\n  };\n  const armResourcesByRoot = groupArmResourcesByRoot(stackAst.resources, authoredContexts);\n\n  const deployments: DeploymentFilePlan[] = [];\n  const pureExistingResources = new Set<string>();\n  const existingResourceToAuthoredResourceGroup = new Map<string, string | undefined>();\n  const existingResourcesWithExplicitScope = new Set<string>();\n  for (const [root, treeResources] of armResourcesByRoot) {\n    const resource = stackAst.resources.get(root)!;\n    const rootContext = authoredContexts.get(root)!;\n    const authoredResourceGroup = rootContext.authoredParent;\n    const moduleScope =\n      rootContext.scopeOrigin === \"pass-through-explicit\"\n        ? authoredResourceGroup === undefined\n          ? undefined\n          : { kind: \"identifier\" as const, id: authoredResourceGroup }\n        : getResourceBody(resource.value).value.scope;\n    if (\n      resource.type === ResourceGroup.resourceType ||\n      (stackAst.targetScope === \"subscription\" && moduleScope === undefined)\n    ) {\n      for (const name of treeResources) entryPlan.resources.add(name);\n    } else if ([...treeResources].every((name) => stackAst.resources.get(name)!.existing)) {\n      for (const name of treeResources) {\n        pureExistingResources.add(name);\n        existingResourceToAuthoredResourceGroup.set(name, authoredResourceGroup);\n        for (\n          let ancestor: string | undefined = name;\n          ancestor !== undefined && ancestor !== authoredResourceGroup;\n          ancestor = authoredContexts.get(ancestor)!.authoredParent\n        ) {\n          const origin = authoredContexts.get(ancestor)!.scopeOrigin;\n          if (origin === \"existing-explicit\" || origin === \"pass-through-explicit\") {\n            existingResourcesWithExplicitScope.add(name);\n            break;\n          }\n        }\n      }\n    } else {\n      deployments.push({\n        boundary: root,\n        resources: treeResources,\n        authoredResourceGroup,\n        moduleScope,\n        targetScope:\n          rootContext.scopeOrigin === \"resourceGroup\" ||\n          (rootContext.scopeOrigin === \"pass-through-explicit\" &&\n            authoredResourceGroup !== undefined)\n            ? \"resourceGroup\"\n            : getTargetScope(moduleScope, stackAst.targetScope),\n      });\n    }\n  }\n  return {\n    entryPlan,\n    deployments,\n    pureExistingResources,\n    existingResourceToAuthoredResourceGroup,\n    existingResourcesWithExplicitScope,\n  };\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/deployment-resource-utils.d.ts

@@ -0,0 +1,8 @@
+import type { ExpressionNode, ResourceDeclarationNode, TargetScope } from "../../ast/index.js";
+import type { AuthoredResourceContext } from "./authored-context.js";
+import type { BicepAst } from "./file-preparation.js";
+export declare function groupArmResourcesByRoot(resources: ReadonlyMap<string, ResourceDeclarationNode>, authoredContexts: ReadonlyMap<string, AuthoredResourceContext>): Map<string, Set<string>>;
+export declare function hasArmParent(name: string, resources: ReadonlyMap<string, ResourceDeclarationNode>, authoredContexts: ReadonlyMap<string, AuthoredResourceContext>): boolean;
+export declare function getTargetScope(scope: ExpressionNode | undefined, fallback: TargetScope): TargetScope;
+export declare function normalizeExtensionScopes(stackAst: BicepAst): void;
+//# sourceMappingURL=deployment-resource-utils.d.ts.map

package/dist/esm/serialization/bicep/file-layout/deployment-resource-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-resource-utils.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/deployment-resource-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,EACvD,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC7D,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAsB1B;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,EACvD,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC7D,OAAO,CAGT;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,QAAQ,EAAE,WAAW,GACpB,WAAW,CAUb;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAyBjE"}

package/dist/esm/serialization/bicep/file-layout/deployment-resource-utils.js

@@ -0,0 +1,67 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ResourceGroup } from "../../../constructs/built-in-resources/resource-group.js";
+import { getResourceArmParentIdentifier, updateResourceBody } from "../../ast/resource-utils.js";
+import { getScopeFunctionTarget } from "../../../expression/utils.js";
+export function groupArmResourcesByRoot(resources, authoredContexts) {
+    const armRootByResource = new Map();
+    function getArmTreeRoot(name) {
+        const cached = armRootByResource.get(name);
+        if (cached !== undefined)
+            return cached;
+        const parent = authoredContexts.get(name).authoredParent;
+        const root = parent === undefined || resources.get(parent).type === ResourceGroup.resourceType
+            ? name
+            : getArmTreeRoot(parent);
+        armRootByResource.set(name, root);
+        return root;
+    }
+    const armResourcesByRoot = new Map();
+    for (const name of resources.keys()) {
+        const root = getArmTreeRoot(name);
+        const treeResources = armResourcesByRoot.get(root) ?? new Set();
+        treeResources.add(name);
+        armResourcesByRoot.set(root, treeResources);
+    }
+    return armResourcesByRoot;
+}
+export function hasArmParent(name, resources, authoredContexts) {
+    const parent = authoredContexts.get(name).authoredParent;
+    return parent !== undefined && resources.get(parent).type !== ResourceGroup.resourceType;
+}
+export function getTargetScope(scope, fallback) {
+    if (scope === undefined)
+        return fallback;
+    if (scope.kind !== "function-call" || typeof scope.target !== "string") {
+        throw new Error("Unsupported authored deployment scope expression.");
+    }
+    const target = getScopeFunctionTarget(scope);
+    if (target !== undefined) {
+        return target;
+    }
+    throw new Error(`Unsupported deployment scope function "${scope.target}".`);
+}
+export function normalizeExtensionScopes(stackAst) {
+    // JSON builders preserve ARM parent metadata; Bicep uses scope for extensions.
+    for (const [name, resource] of stackAst.resources) {
+        const armParentIdentifier = getResourceArmParentIdentifier(resource);
+        const armParent = armParentIdentifier === undefined ? undefined : stackAst.resources.get(armParentIdentifier);
+        if (armParentIdentifier !== undefined && armParent === undefined) {
+            throw new Error(`Missing ARM parent "${armParentIdentifier}" for resource "${name}".`);
+        }
+        if (armParent !== undefined &&
+            !resource.type.toLowerCase().startsWith(`${armParent.type.toLowerCase()}/`)) {
+            stackAst.resources.set(name, {
+                ...resource,
+                value: updateResourceBody(resource.value, (body) => {
+                    const { parent: target, ...rest } = body.value;
+                    if (target === undefined) {
+                        throw new Error(`Missing extension target for "${name}".`);
+                    }
+                    return { ...body, value: { scope: target, ...rest } };
+                }),
+            });
+        }
+    }
+}
+//# sourceMappingURL=deployment-resource-utils.js.map

package/dist/esm/serialization/bicep/file-layout/deployment-resource-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-resource-utils.js","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/deployment-resource-utils.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { ResourceGroup } from \"../../../constructs/built-in-resources/resource-group.js\";\nimport type { ExpressionNode, ResourceDeclarationNode, TargetScope } from \"../../ast/index.js\";\nimport { getResourceArmParentIdentifier, updateResourceBody } from \"../../ast/resource-utils.js\";\nimport { getScopeFunctionTarget } from \"../../../expression/utils.js\";\nimport type { AuthoredResourceContext } from \"./authored-context.js\";\nimport type { BicepAst } from \"./file-preparation.js\";\n\nexport function groupArmResourcesByRoot(\n  resources: ReadonlyMap<string, ResourceDeclarationNode>,\n  authoredContexts: ReadonlyMap<string, AuthoredResourceContext>,\n): Map<string, Set<string>> {\n  const armRootByResource = new Map<string, string>();\n  function getArmTreeRoot(name: string): string {\n    const cached = armRootByResource.get(name);\n    if (cached !== undefined) return cached;\n    const parent = authoredContexts.get(name)!.authoredParent;\n    const root =\n      parent === undefined || resources.get(parent)!.type === ResourceGroup.resourceType\n        ? name\n        : getArmTreeRoot(parent);\n    armRootByResource.set(name, root);\n    return root;\n  }\n\n  const armResourcesByRoot = new Map<string, Set<string>>();\n  for (const name of resources.keys()) {\n    const root = getArmTreeRoot(name);\n    const treeResources = armResourcesByRoot.get(root) ?? new Set<string>();\n    treeResources.add(name);\n    armResourcesByRoot.set(root, treeResources);\n  }\n  return armResourcesByRoot;\n}\n\nexport function hasArmParent(\n  name: string,\n  resources: ReadonlyMap<string, ResourceDeclarationNode>,\n  authoredContexts: ReadonlyMap<string, AuthoredResourceContext>,\n): boolean {\n  const parent = authoredContexts.get(name)!.authoredParent;\n  return parent !== undefined && resources.get(parent)!.type !== ResourceGroup.resourceType;\n}\n\nexport function getTargetScope(\n  scope: ExpressionNode | undefined,\n  fallback: TargetScope,\n): TargetScope {\n  if (scope === undefined) return fallback;\n  if (scope.kind !== \"function-call\" || typeof scope.target !== \"string\") {\n    throw new Error(\"Unsupported authored deployment scope expression.\");\n  }\n  const target = getScopeFunctionTarget(scope);\n  if (target !== undefined) {\n    return target;\n  }\n  throw new Error(`Unsupported deployment scope function \"${scope.target}\".`);\n}\n\nexport function normalizeExtensionScopes(stackAst: BicepAst): void {\n  // JSON builders preserve ARM parent metadata; Bicep uses scope for extensions.\n  for (const [name, resource] of stackAst.resources) {\n    const armParentIdentifier = getResourceArmParentIdentifier(resource);\n    const armParent =\n      armParentIdentifier === undefined ? undefined : stackAst.resources.get(armParentIdentifier);\n    if (armParentIdentifier !== undefined && armParent === undefined) {\n      throw new Error(`Missing ARM parent \"${armParentIdentifier}\" for resource \"${name}\".`);\n    }\n    if (\n      armParent !== undefined &&\n      !resource.type.toLowerCase().startsWith(`${armParent.type.toLowerCase()}/`)\n    ) {\n      stackAst.resources.set(name, {\n        ...resource,\n        value: updateResourceBody(resource.value, (body) => {\n          const { parent: target, ...rest } = body.value;\n          if (target === undefined) {\n            throw new Error(`Missing extension target for \"${name}\".`);\n          }\n          return { ...body, value: { scope: target, ...rest } };\n        }),\n      });\n    }\n  }\n}\n"]}

package/dist/esm/serialization/bicep/file-layout/file-dependencies.d.ts

@@ -0,0 +1,4 @@
+import type { ResourceDeclarationNode } from "../../ast/index.js";
+import type { BicepAst } from "./file-preparation.js";
+export declare function resolveFileDependencies(ast: BicepAst, stackAst: BicepAst, lookups: ReadonlyMap<string, ResourceDeclarationNode>): void;
+//# sourceMappingURL=file-dependencies.d.ts.map

package/dist/esm/serialization/bicep/file-layout/file-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-dependencies.d.ts","sourceRoot":"","sources":["../../../../../src/serialization/bicep/file-layout/file-dependencies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,uBAAuB,CAAC,GACpD,IAAI,CA4BN"}

package/dist/esm/serialization/bicep/file-layout/file-dependencies.js

@@ -0,0 +1,32 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { collectDependenciesForDeclaration } from "../../ast/declaration-dependencies.js";
+export function resolveFileDependencies(ast, stackAst, lookups) {
+    const declarations = new Map([
+        ...stackAst.variables,
+        ...stackAst.parameters,
+        ...lookups,
+        ...ast.resources,
+    ]);
+    const references = collectDependenciesForDeclaration([...ast.resources.values(), ...ast.outputs.values(), ...ast.modules.values()], { recursive: true, declarations });
+    const selectedResources = new Map([...lookups, ...ast.resources]);
+    const includedResources = new Set(ast.resources.keys());
+    ast.resources.clear();
+    for (const name of stackAst.resources.keys()) {
+        const resource = selectedResources.get(name);
+        if (resource !== undefined && (includedResources.has(name) || references.has(name))) {
+            ast.resources.set(name, resource);
+        }
+    }
+    ast.variables.clear();
+    for (const [name, variable] of stackAst.variables) {
+        if (references.has(name))
+            ast.variables.set(name, variable);
+    }
+    ast.parameters.clear();
+    for (const [name, parameter] of stackAst.parameters) {
+        if (references.has(name))
+            ast.parameters.set(name, parameter);
+    }
+}
+//# sourceMappingURL=file-dependencies.js.map