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

package/dist/commonjs/serialization/arm-object-conversion.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/serialization/arm-object-conversion.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\n/**\n * Client/ARM object conversion.\n *\n * convertToArmObject maps JS property names to ARM paths, restores flattened\n * nesting, and encodes terminal values using the supplied model shape.\n * convertFromArmObject performs the inverse conversion for deserialization.\n * Both follow nested model, array, and record shapes and preserve unknown\n * keys. Property-access expression lowering lives in the AST expression builder.\n */\n\nimport {\n  isTerminalValueShape,\n  type ModelShape,\n  type ValueShape,\n  resolveModelShape,\n} from \"../shape/shape.js\";\nimport { isExpression } from \"../expression/expressions.js\";\nimport { isExpressionNode } from \"../expression/ast-nodes.js\";\nimport { decodeWireValue, encodeWireValue } from \"./encoding.js\";\n\nconst MISSING = Symbol(\"missing\");\n\nfunction assertNeverValueShape(shape: never): never {\n  throw new Error(`Unhandled value shape: ${String(shape)}`);\n}\n\n// ---------------------------------------------------------------------------\n// Client object to ARM object\n// ---------------------------------------------------------------------------\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (value === null || typeof value !== \"object\") return false;\n  // Expression proxies are opaque values (despite a null prototype) \u2014 they\n  // must not be treated as cloneable plain objects.\n  if (isExpression(value)) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\n/**\n * Recursively convert a client object into its ARM wire shape. Keys\n * not present in `shape.byJsName` pass through unchanged. Multi-\n * segment ARM paths (from `@flattenProperty`) re-nest objects; nested\n * models, arrays-of-models and records-of-models recurse via\n * `target`. Empty ARM paths fall back to the JS property name.\n *\n * Collisions where two JS-side keys map to overlapping ARM paths merge\n * when both sides are compatible objects; non-object / object collisions\n * throw.\n */\nexport function convertToArmObject(\n  state: Record<string, unknown>,\n  shape: ModelShape,\n  visited: WeakSet<object> = new WeakSet(),\n): Record<string, unknown> {\n  if (visited.has(state)) {\n    throw new Error(\"Cycle detected while lowering ARM state.\");\n  }\n  visited.add(state);\n  try {\n    const out: Record<string, unknown> = Object.create(null);\n    // Select the variant once, from the state we're about to lower \u2014\n    // every key below is looked up against that one concrete shape.\n    const flat = resolveModelShape(shape, state, \"js\");\n\n    for (const [jsKey, rawValue] of Object.entries(state)) {\n      const propShape = flat?.byJsName[jsKey];\n      const path = propShape?.armPath.length ? propShape.armPath : [jsKey];\n      const loweredValue = lowerValue(rawValue, propShape?.value, visited, path);\n\n      if (!propShape) {\n        // Passthrough: key not in shape (e.g. CDK-internal, or emitter\n        // didn't include it).\n        assignPath(out, [jsKey], loweredValue);\n        continue;\n      }\n\n      assignPath(out, path, loweredValue);\n    }\n\n    return out;\n  } finally {\n    visited.delete(state);\n  }\n}\n\nfunction lowerValue(\n  value: unknown,\n  shape: ValueShape | undefined,\n  visited: WeakSet<object>,\n  path: readonly string[],\n): unknown {\n  if (value === null || value === undefined) return value;\n  if (isExpression(value) || isExpressionNode(value)) return value;\n\n  if (!shape) {\n    return value;\n  }\n\n  if (isTerminalValueShape(shape)) {\n    if (\"encoding\" in shape && shape.encoding) {\n      return encodeWireValue(value, shape.encoding, path);\n    }\n    return value;\n  }\n\n  switch (shape.kind) {\n    case \"deferred\":\n      if (!isPlainObject(value)) return value;\n      // `convertToArmObject` resolves the variant itself, per property, using\n      // `value` as the discriminator source.\n      return convertToArmObject(value, shape.value(), visited);\n    case \"array\":\n      if (!Array.isArray(value)) return value;\n      return value.map((item, index) =>\n        lowerValue(item, shape.element, visited, [...path, String(index)]),\n      );\n    case \"record\": {\n      if (!isPlainObject(value)) return value;\n      const out: Record<string, unknown> = Object.create(null);\n      for (const [k, v] of Object.entries(value)) {\n        defineOwn(out, k, lowerValue(v, shape.value, visited, [...path, k]));\n      }\n      return out;\n    }\n    case \"tuple\":\n      if (!Array.isArray(value)) return value;\n      return value.map((item, index) =>\n        lowerValue(item, shape.values[index], visited, [...path, String(index)]),\n      );\n    default:\n      return assertNeverValueShape(shape);\n  }\n}\n\n/**\n * Write `value` into `target` at the given ARM path, deep-merging with\n * existing object values. Throws on non-object/object or\n * object/non-object collisions.\n */\nfunction assignPath(\n  target: Record<string, unknown>,\n  path: readonly string[],\n  value: unknown,\n): void {\n  if (path.length === 0) return;\n\n  let cursor = target;\n  for (let i = 0; i < path.length - 1; i++) {\n    const seg = path[i]!;\n    const existing = Object.prototype.hasOwnProperty.call(cursor, seg) ? cursor[seg] : undefined;\n    if (existing === undefined) {\n      const next: Record<string, unknown> = Object.create(null);\n      defineOwn(cursor, seg, next);\n      cursor = next;\n    } else if (isPlainObject(existing)) {\n      cursor = existing;\n    } else {\n      throw new Error(\n        `ARM path collision at \"${path.slice(0, i + 1).join(\".\")}\": expected object, got ${typeof existing}.`,\n      );\n    }\n  }\n\n  const leafKey = path[path.length - 1]!;\n  const existingLeaf = Object.prototype.hasOwnProperty.call(cursor, leafKey)\n    ? cursor[leafKey]\n    : undefined;\n  if (existingLeaf === undefined) {\n    defineOwn(cursor, leafKey, value);\n    return;\n  }\n\n  if (isPlainObject(existingLeaf) && isPlainObject(value)) {\n    defineOwn(\n      cursor,\n      leafKey,\n      deepMerge(existingLeaf as Record<string, unknown>, value as Record<string, unknown>, path),\n    );\n    return;\n  }\n\n  throw new Error(\n    `ARM path collision at \"${path.join(\".\")}\": cannot merge ${typeof existingLeaf} with ${typeof value}.`,\n  );\n}\n\nfunction deepMerge(\n  a: Record<string, unknown>,\n  b: Record<string, unknown>,\n  prefix: readonly string[],\n): Record<string, unknown> {\n  const out: Record<string, unknown> = Object.create(null);\n  for (const [key, value] of Object.entries(a)) defineOwn(out, key, value);\n  for (const [k, v] of Object.entries(b)) {\n    const existing = Object.prototype.hasOwnProperty.call(out, k) ? out[k] : undefined;\n    if (existing === undefined) {\n      defineOwn(out, k, v);\n      continue;\n    }\n    if (isPlainObject(existing) && isPlainObject(v)) {\n      defineOwn(\n        out,\n        k,\n        deepMerge(existing as Record<string, unknown>, v as Record<string, unknown>, [\n          ...prefix,\n          k,\n        ]),\n      );\n      continue;\n    }\n    throw new Error(\n      `ARM path collision at \"${[...prefix, k].join(\".\")}\": cannot merge ${typeof existing} with ${typeof v}.`,\n    );\n  }\n  return out;\n}\n\nfunction defineOwn(target: Record<string, unknown>, key: string, value: unknown): void {\n  Object.defineProperty(target, key, {\n    value,\n    enumerable: true,\n    configurable: true,\n    writable: true,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// ARM object to client object\n// ---------------------------------------------------------------------------\n\n/**\n * Inverse of `convertToArmObject`: walks an ARM object and maps\n * values at each property entry's `armPath` back onto the flat\n * `jsName` key. Recurses into nested model / array / record values via\n * `target`. Empty ARM paths fall back to the JS property name.\n *\n * ARM-shape keys that consumed a nested object entirely (single-segment\n * paths carrying a model `target`) pop that segment from the source\n * so leftovers at intermediate nodes don't silently leak into the\n * output. For multi-segment paths (`@flattenProperty`), only the leaf\n * is extracted; intermediate shared objects may survive as their own\n * top-level entries if the shape also declares a jsName for them.\n *\n * Keys present in the state but not consumed by any property entry\n * pass through unchanged (preserving the \"unknown key\" escape hatch\n * documented in `convertToArmObject`).\n */\nexport function convertFromArmObject(\n  state: Record<string, unknown>,\n  shape: ModelShape,\n  visited: WeakSet<object> = new WeakSet(),\n): Record<string, unknown> {\n  if (visited.has(state)) {\n    throw new Error(\"Cycle detected while raising ARM state.\");\n  }\n  visited.add(state);\n  try {\n    // Wire-shaped input, so the variant is selected against ARM keys.\n    const flat = resolveModelShape(shape, state, \"arm\");\n    if (!flat) return structuredCloneLike(state, new WeakSet());\n\n    // Clone into a mutable working copy so we can prune consumed paths.\n    const working: Record<string, unknown> = structuredCloneLike(state, new WeakSet());\n    const out: Record<string, unknown> = Object.create(null);\n    const consumedTopLevel = new Set<string>();\n\n    for (const [jsName, propShape] of Object.entries(flat.byJsName)) {\n      const path = propShape.armPath.length > 0 ? propShape.armPath : [jsName];\n      const extracted = extractPath(working, path);\n      if (extracted === MISSING) continue;\n\n      const raised = raiseValue(extracted, propShape.value, visited, path);\n      defineOwn(out, jsName, raised);\n\n      consumedTopLevel.add(path[0]!);\n    }\n\n    // Passthrough: anything left in `working` that wasn't consumed by a\n    // shape-driven extraction and doesn't collide with an already-\n    // placed jsName.\n    for (const [k, v] of Object.entries(working)) {\n      if (consumedTopLevel.has(k)) {\n        // Top-level segment was touched by at least one armPath. If\n        // residue remains (e.g. sibling properties the shape didn't\n        // cover), surface it under the original ARM key so it's not\n        // silently dropped.\n        if (isPlainObject(v) && Object.keys(v).length === 0) continue;\n        if (v === undefined) continue;\n      }\n      if (Object.prototype.hasOwnProperty.call(out, k)) continue;\n      defineOwn(out, k, v);\n    }\n\n    return out;\n  } finally {\n    visited.delete(state);\n  }\n}\n\nfunction raiseValue(\n  value: unknown,\n  shape: ValueShape | undefined,\n  visited: WeakSet<object>,\n  path: readonly string[],\n): unknown {\n  if (value === null || value === undefined) return value;\n  if (isExpression(value) || isExpressionNode(value)) return value;\n  if (!shape) return value;\n\n  if (isTerminalValueShape(shape)) {\n    if (\"encoding\" in shape && shape.encoding) {\n      return decodeWireValue(value, shape.encoding, path);\n    }\n    return value;\n  }\n\n  switch (shape.kind) {\n    case \"deferred\":\n      if (!isPlainObject(value)) return value;\n      // `convertFromArmObject` selects the variant itself, against ARM keys.\n      return convertFromArmObject(value, shape.value(), visited);\n    case \"array\":\n      if (!Array.isArray(value)) return value;\n      return value.map((item, index) =>\n        raiseValue(item, shape.element, visited, [...path, String(index)]),\n      );\n    case \"record\": {\n      if (!isPlainObject(value)) return value;\n      const out: Record<string, unknown> = Object.create(null);\n      for (const [k, v] of Object.entries(value)) {\n        defineOwn(out, k, raiseValue(v, shape.value, visited, [...path, k]));\n      }\n      return out;\n    }\n    case \"tuple\":\n      if (!Array.isArray(value)) return value;\n      return value.map((item, index) =>\n        raiseValue(item, shape.values[index], visited, [...path, String(index)]),\n      );\n    default:\n      return assertNeverValueShape(shape);\n  }\n}\n\n/**\n * Walk `obj` along `path`, returning the leaf value and pruning it\n * from the tree. Empty intermediate objects are left in place (caller\n * decides how to treat residue).\n *\n * Returns `MISSING` when any segment is absent or not a plain object.\n */\nfunction extractPath(obj: Record<string, unknown>, path: readonly string[]): unknown {\n  if (path.length === 0) return obj;\n\n  let cursor: Record<string, unknown> = obj;\n  for (let i = 0; i < path.length - 1; i++) {\n    const seg = path[i]!;\n    const next = Object.prototype.hasOwnProperty.call(cursor, seg) ? cursor[seg] : undefined;\n    if (!isPlainObject(next)) return MISSING;\n    cursor = next;\n  }\n\n  const leafKey = path[path.length - 1]!;\n  if (!Object.prototype.hasOwnProperty.call(cursor, leafKey)) return MISSING;\n  const value = cursor[leafKey];\n  delete cursor[leafKey];\n  return value;\n}\n\n/**\n * Shallow-clone recursively enough to avoid mutating caller state.\n * We only copy plain objects; arrays and other values are shared\n * (raiseValue handles arrays via `.map` so mutation is contained).\n */\nfunction structuredCloneLike(\n  value: Record<string, unknown>,\n  seen: WeakSet<object>,\n): Record<string, unknown> {\n  if (seen.has(value)) {\n    // Preserve the cycle for downstream detection in convertFromArmObject.\n    return value;\n  }\n  seen.add(value);\n  const out: Record<string, unknown> = Object.create(null);\n  for (const [k, v] of Object.entries(value)) {\n    defineOwn(\n      out,\n      k,\n      isExpression(v) || isExpressionNode(v)\n        ? v\n        : isPlainObject(v)\n          ? structuredCloneLike(v, seen)\n          : v,\n    );\n  }\n  return out;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/commonjs/serialization/ast/declaration-builder.d.ts

@@ -0,0 +1,10 @@
+import type { Stack } from "../../constructs/stack.js";
+import type { ResourceDeclaration } from "../../constructs/resource/resource.js";
+import type { InfraNode, OutputDeclarationNode, ParameterDeclarationNode, ResourceDeclarationNode, VariableDeclarationNode } from "./index.js";
+import type { DeclarationSymbolMap } from "../symbol-map.js";
+export declare function buildResourceDeclaration(resource: ResourceDeclaration, symbolMap: DeclarationSymbolMap): [string, ResourceDeclarationNode];
+export declare function buildParameterDeclarations(stack: Stack, symbolMap: DeclarationSymbolMap): Record<string, ParameterDeclarationNode> | undefined;
+export declare function buildVariableDeclarations(stack: Stack, symbolMap: DeclarationSymbolMap): Record<string, VariableDeclarationNode> | undefined;
+export declare function buildOutputDeclarations(stack: Stack, symbolMap: DeclarationSymbolMap): Record<string, OutputDeclarationNode> | undefined;
+export declare function buildStackDeclarations(stack: Stack, resources: readonly ResourceDeclaration[], symbols: DeclarationSymbolMap): Pick<InfraNode, "parameters" | "variables" | "resources" | "outputs">;
+//# sourceMappingURL=declaration-builder.d.ts.map

package/dist/commonjs/serialization/ast/declaration-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration-builder.d.ts","sourceRoot":"","sources":["../../../../src/serialization/ast/declaration-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAY,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAU3F,OAAO,KAAK,EAIV,SAAS,EACT,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAyJ7D,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,oBAAoB,GAC9B,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAsDnC;AA0CD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,SAAS,CAiBtD;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAAG,SAAS,CAarD;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,SAAS,CAyBnD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAAC,SAAS,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,CAYvE"}

package/dist/commonjs/serialization/ast/declaration-builder.js

@@ -0,0 +1,274 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var declaration_builder_exports = {};
+__export(declaration_builder_exports, {
+  buildOutputDeclarations: () => buildOutputDeclarations,
+  buildParameterDeclarations: () => buildParameterDeclarations,
+  buildResourceDeclaration: () => buildResourceDeclaration,
+  buildStackDeclarations: () => buildStackDeclarations,
+  buildVariableDeclarations: () => buildVariableDeclarations
+});
+module.exports = __toCommonJS(declaration_builder_exports);
+var import_resource_proxy = require("../../constructs/resource/resource-proxy.js");
+var import_util = require("../../util.js");
+var import_shape_registry = require("../../shape/shape-registry.js");
+var import_expressions = require("../../expression/expressions.js");
+var import_ast_nodes = require("../../expression/ast-nodes.js");
+var import_resource_utils = require("../../constructs/resource/resource-utils.js");
+var import_resource_relationships = require("../../constructs/resource/resource-relationships.js");
+var import_arm_object_conversion = require("../arm-object-conversion.js");
+var import_expression_builder = require("./expression-builder.js");
+const RESOURCE_RESERVED_KEYS = /* @__PURE__ */ new Set([
+  "apiVersion",
+  "existing",
+  "id",
+  "name",
+  "scope",
+  "type",
+  "condition",
+  "dependsOn",
+  import_resource_proxy.STATE_PARENT_INDEX
+]);
+function hasNestedResourceHandle(value) {
+  if ((0, import_expressions.isExpression)(value) || (0, import_ast_nodes.isExpressionNode)(value)) {
+    return false;
+  }
+  if ((0, import_resource_utils.isResource)(value)) {
+    return true;
+  }
+  if (Array.isArray(value)) {
+    return value.some((item) => hasNestedResourceHandle(item));
+  }
+  if (typeof value === "object" && value !== null) {
+    return Object.values(value).some((item) => hasNestedResourceHandle(item));
+  }
+  return false;
+}
+function buildResourceProperties(resource, symbolMap) {
+  const rawResource = (0, import_resource_proxy.unwrapResourceHandle)(resource);
+  const properties = {
+    name: (0, import_expression_builder.buildExpression)(rawResource.name, symbolMap)
+  };
+  const armParent = (0, import_resource_relationships.getArmParent)(resource);
+  if (armParent !== void 0) {
+    const parentId = symbolMap.get(armParent);
+    if (parentId === void 0) {
+      throw new Error(`Missing parent symbol for resource type ${rawResource.type}.`);
+    }
+    const parentNode = { kind: "identifier", id: parentId };
+    const parentIndex = rawResource[import_resource_proxy.STATE_PARENT_INDEX];
+    if (parentIndex !== void 0) {
+      properties.parent = {
+        kind: "array-access",
+        base: parentNode,
+        index: (0, import_expression_builder.buildExpression)(parentIndex, symbolMap),
+        nullish: false,
+        fromEnd: false
+      };
+    } else {
+      properties.parent = parentNode;
+    }
+  }
+  const scopeValue = (0, import_resource_relationships.getResourceScope)(resource);
+  if (scopeValue !== void 0) {
+    properties.scope = (0, import_expression_builder.buildExpression)(scopeValue, symbolMap);
+  } else if (armParent === void 0) {
+    const rgAncestor = (0, import_resource_relationships.getResourceGroupAncestor)(resource);
+    if (rgAncestor !== void 0) {
+      const groupId = symbolMap.get(rgAncestor);
+      if (groupId === void 0) {
+        throw new Error("Resource group not found in symbol map.");
+      }
+      properties.scope = {
+        kind: "identifier",
+        id: groupId
+      };
+    }
+  }
+  const dependsOn = rawResource["dependsOn"];
+  if (dependsOn !== void 0) {
+    properties.dependsOn = {
+      kind: "array",
+      items: dependsOn.map((dependency) => {
+        const identifier = symbolMap.get(dependency);
+        if (identifier === void 0) {
+          throw new Error(
+            "Dependency not found in symbol map. Ensure it belongs to the same stack."
+          );
+        }
+        return { kind: "identifier", id: identifier };
+      })
+    };
+  }
+  const descriptor = typeof rawResource.type === "string" && typeof rawResource.apiVersion === "string" ? (0, import_shape_registry.getShape)(
+    rawResource.type,
+    rawResource.apiVersion,
+    rawResource
+  ) : void 0;
+  const userProps = {};
+  for (const [key, value] of Object.entries(rawResource)) {
+    if (rawResource.existing) continue;
+    if (value === void 0 || RESOURCE_RESERVED_KEYS.has(key) || hasNestedResourceHandle(value)) {
+      continue;
+    }
+    userProps[key] = value;
+  }
+  const loweredUserProps = descriptor ? (0, import_arm_object_conversion.convertToArmObject)(userProps, descriptor) : userProps;
+  for (const key of Object.keys(loweredUserProps).sort()) {
+    properties[key] = (0, import_expression_builder.buildExpression)(loweredUserProps[key], symbolMap);
+  }
+  return properties;
+}
+function buildResourceDeclaration(resource, symbolMap) {
+  const resourceId = symbolMap.get(resource);
+  if (resourceId === void 0) {
+    throw new Error(`Missing synthesized symbol for resource type ${resource.type}.`);
+  }
+  const properties = buildResourceProperties(resource, symbolMap);
+  const rawResource = (0, import_resource_proxy.unwrapResourceHandle)(resource);
+  const condition = rawResource["condition"] !== void 0 ? (0, import_expression_builder.buildExpression)(rawResource["condition"], symbolMap) : void 0;
+  const loopCtx = (0, import_resource_utils.isLoopedResource)(resource) ? resource.loop : void 0;
+  const batchSize = loopCtx?.batchSize;
+  const decorators = batchSize !== void 0 ? { batchSize } : void 0;
+  let wireValue = { kind: "object", value: properties };
+  if (condition !== void 0) {
+    wireValue = { kind: "if-condition", condition, body: wireValue };
+  }
+  if (loopCtx !== void 0) {
+    wireValue = {
+      kind: "for-expression",
+      itemVariable: loopCtx.itemVariable,
+      ...loopCtx.indexVariable !== void 0 ? { indexVariable: loopCtx.indexVariable } : {},
+      collection: (0, import_expression_builder.buildExpression)(loopCtx.collection, symbolMap),
+      body: wireValue
+    };
+  }
+  const node = {
+    bicepIdentifier: resourceId,
+    type: resource.type,
+    apiVersion: resource.apiVersion,
+    existing: resource.existing ?? false,
+    value: wireValue,
+    ...decorators !== void 0 ? { decorators } : {}
+  };
+  return [resourceId, node];
+}
+function buildDecorators(decl, symbolMap) {
+  const d = {};
+  if (decl.description !== void 0) d.description = decl.description;
+  if ("secure" in decl && decl.secure) d.secure = true;
+  if ("minValue" in decl && decl.minValue !== void 0) {
+    d.minValue = decl.minValue;
+  }
+  if ("maxValue" in decl && decl.maxValue !== void 0) {
+    d.maxValue = decl.maxValue;
+  }
+  if ("minLength" in decl && decl.minLength !== void 0) {
+    d.minLength = decl.minLength;
+  }
+  if ("maxLength" in decl && decl.maxLength !== void 0) {
+    d.maxLength = decl.maxLength;
+  }
+  if ("metadata" in decl && decl.metadata !== void 0) {
+    d.metadata = (0, import_expression_builder.buildExpressionProperties)(
+      decl.metadata,
+      symbolMap
+    );
+  }
+  if ("allowed" in decl && decl.allowed !== void 0) {
+    d.allowed = decl.allowed.map((v) => (0, import_expression_builder.buildExpression)(v, symbolMap));
+  }
+  if ("discriminator" in decl && decl.discriminator !== void 0) {
+    d.discriminator = decl.discriminator;
+  }
+  if ("sealed" in decl && decl.sealed) d.sealed = true;
+  if ("export" in decl && decl.export) d.export = true;
+  return Object.keys(d).length > 0 ? d : void 0;
+}
+function buildParameterDeclarations(stack, symbolMap) {
+  if (stack.parameters.size === 0) return void 0;
+  return Object.fromEntries(
+    stack.parameters.listMetadata().map((p) => {
+      const identifier = symbolMap.get(p);
+      const node = (0, import_util.definedProps)({
+        bicepIdentifier: identifier,
+        valueType: { kind: "primitive-type", name: p.type },
+        defaultValue: p.defaultValue !== void 0 ? (0, import_expression_builder.buildExpression)(p.defaultValue, symbolMap) : void 0,
+        decorators: buildDecorators(p, symbolMap)
+      });
+      return [identifier, node];
+    })
+  );
+}
+function buildVariableDeclarations(stack, symbolMap) {
+  if (stack.variables.size === 0) return void 0;
+  return Object.fromEntries(
+    stack.variables.listMetadata().map((v) => {
+      const identifier = symbolMap.get(v);
+      const node = (0, import_util.definedProps)({
+        bicepIdentifier: identifier,
+        value: (0, import_expression_builder.buildExpression)(v.value, symbolMap),
+        decorators: buildDecorators(v, symbolMap)
+      });
+      return [identifier, node];
+    })
+  );
+}
+function buildOutputDeclarations(stack, symbolMap) {
+  if (stack.outputs.size === 0) return void 0;
+  return Object.fromEntries(
+    stack.outputs.list().map((o) => {
+      let value;
+      if ((0, import_resource_utils.isResource)(o.value)) {
+        const symbol = symbolMap.get(o.value);
+        if (symbol === void 0) {
+          throw new Error(`Resource not found in symbol map. Ensure it belongs to the same stack.`);
+        }
+        value = { kind: "identifier", id: symbol };
+      } else {
+        value = (0, import_expression_builder.buildExpression)(o.value, symbolMap);
+      }
+      const node = (0, import_util.definedProps)({
+        bicepIdentifier: o.name,
+        valueType: { kind: "primitive-type", name: o.type },
+        value,
+        decorators: buildDecorators(o, symbolMap)
+      });
+      return [o.name, node];
+    })
+  );
+}
+function buildStackDeclarations(stack, resources, symbols) {
+  return (0, import_util.definedProps)({
+    parameters: buildParameterDeclarations(stack, symbols),
+    variables: buildVariableDeclarations(stack, symbols),
+    resources: resources.length === 0 ? void 0 : Object.fromEntries(
+      resources.map((resource) => buildResourceDeclaration(resource, symbols))
+    ),
+    outputs: buildOutputDeclarations(stack, symbols)
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildOutputDeclarations,
+  buildParameterDeclarations,
+  buildResourceDeclaration,
+  buildStackDeclarations,
+  buildVariableDeclarations
+});
+//# sourceMappingURL=declaration-builder.js.map

package/dist/commonjs/serialization/ast/declaration-builder.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/serialization/ast/declaration-builder.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { ParameterMetadata } from \"../../constructs/parameter.js\";\nimport type { VariableMetadata } from \"../../constructs/variable.js\";\nimport type { OutputMetadata } from \"../../constructs/output.js\";\nimport type { Stack } from \"../../constructs/stack.js\";\nimport type { Resource, ResourceDeclaration } from \"../../constructs/resource/resource.js\";\nimport {\n  STATE_PARENT_INDEX,\n  unwrapResourceHandle,\n} from \"../../constructs/resource/resource-proxy.js\";\nimport { definedProps } from \"../../util.js\";\nimport { getShape } from \"../../shape/shape-registry.js\";\nimport { isExpression } from \"../../expression/expressions.js\";\nimport { isExpressionNode } from \"../../expression/ast-nodes.js\";\nimport { isResource, isLoopedResource } from \"../../constructs/resource/resource-utils.js\";\nimport type {\n  DeclarableBodyNode,\n  DecoratorsNode,\n  ExpressionNode,\n  InfraNode,\n  OutputDeclarationNode,\n  ParameterDeclarationNode,\n  ResourceDeclarationNode,\n  VariableDeclarationNode,\n} from \"./index.js\";\nimport type { DeclarationSymbolMap } from \"../symbol-map.js\";\nimport {\n  getArmParent,\n  getResourceGroupAncestor,\n  getResourceScope,\n} from \"../../constructs/resource/resource-relationships.js\";\nimport { convertToArmObject } from \"../arm-object-conversion.js\";\nimport {\n  buildExpressionProperties,\n  buildExpression,\n  type ExpressionNodeInput,\n} from \"./expression-builder.js\";\n\nconst RESOURCE_RESERVED_KEYS = new Set<string>([\n  \"apiVersion\",\n  \"existing\",\n  \"id\",\n  \"name\",\n  \"scope\",\n  \"type\",\n  \"condition\",\n  \"dependsOn\",\n  STATE_PARENT_INDEX,\n]);\n\nfunction hasNestedResourceHandle(value: unknown): boolean {\n  if (isExpression(value) || isExpressionNode(value)) {\n    return false;\n  }\n\n  if (isResource(value)) {\n    return true;\n  }\n\n  if (Array.isArray(value)) {\n    return value.some((item) => hasNestedResourceHandle(item));\n  }\n\n  if (typeof value === \"object\" && value !== null) {\n    return Object.values(value).some((item) => hasNestedResourceHandle(item));\n  }\n\n  return false;\n}\n\nfunction buildResourceProperties(\n  resource: ResourceDeclaration,\n  symbolMap: DeclarationSymbolMap,\n): Record<string, ExpressionNode> {\n  const rawResource = unwrapResourceHandle(resource as unknown as Resource);\n  const properties: Record<string, ExpressionNode> = {\n    name: buildExpression(rawResource.name, symbolMap),\n  };\n\n  const armParent = getArmParent(resource);\n  if (armParent !== undefined) {\n    const parentId = symbolMap.get(armParent);\n\n    if (parentId === undefined) {\n      throw new Error(`Missing parent symbol for resource type ${rawResource.type}.`);\n    }\n\n    const parentNode: ExpressionNode = { kind: \"identifier\", id: parentId };\n    // Explicit parent index recorded by `Resource`'s constructor when a\n    // child is created with `parent.at(i)` / `parent.current()` as its\n    // context. When the child is created under a looped parent without an\n    // explicit index (only reachable by unwrapping the raw handle out of a\n    // `LoopedResource` \u2014 not part of the user-facing API), we emit\n    // `parent: parentSym` unchanged; Bicep rejects the resulting\n    // `parent: parents` (an array) at validation, producing a loud failure\n    // instead of a silently-guessed index variable.\n    const parentIndex = (rawResource as unknown as Record<string, unknown>)[STATE_PARENT_INDEX];\n\n    if (parentIndex !== undefined) {\n      properties.parent = {\n        kind: \"array-access\",\n        base: parentNode,\n        index: buildExpression(parentIndex as ExpressionNodeInput, symbolMap),\n        nullish: false,\n        fromEnd: false,\n      };\n    } else {\n      properties.parent = parentNode;\n    }\n  }\n\n  // Explicit scope comes from existing lookups or preserved import data.\n  const scopeValue = getResourceScope(resource);\n  if (scopeValue !== undefined) {\n    properties.scope = buildExpression(scopeValue, symbolMap);\n  } else if (armParent === undefined) {\n    const rgAncestor = getResourceGroupAncestor(resource);\n    if (rgAncestor !== undefined) {\n      const groupId = symbolMap.get(rgAncestor);\n      if (groupId === undefined) {\n        throw new Error(\"Resource group not found in symbol map.\");\n      }\n      properties.scope = {\n        kind: \"identifier\",\n        id: groupId,\n      };\n    }\n  }\n\n  const dependsOn = (rawResource as unknown as Record<string, unknown>)[\"dependsOn\"] as\n    readonly ResourceDeclaration[] | undefined;\n  if (dependsOn !== undefined) {\n    properties.dependsOn = {\n      kind: \"array\",\n      items: dependsOn.map((dependency) => {\n        const identifier = symbolMap.get(dependency);\n        if (identifier === undefined) {\n          throw new Error(\n            \"Dependency not found in symbol map. Ensure it belongs to the same stack.\",\n          );\n        }\n        return { kind: \"identifier\", id: identifier };\n      }),\n    };\n  }\n\n  // Build the per-resource custom property bag first, applying ARM-\n  // shape lowering (rename/flatten/encode) when a shape is\n  // registered for `(type, apiVersion)`. The registry resolves\n  // discriminated variants from the instance state. No-op when no\n  // shape is registered for this resource type.\n  const descriptor =\n    typeof rawResource.type === \"string\" && typeof rawResource.apiVersion === \"string\"\n      ? getShape(\n          rawResource.type,\n          rawResource.apiVersion,\n          rawResource as unknown as Record<string, unknown>,\n        )\n      : undefined;\n\n  const userProps: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(rawResource)) {\n    if (rawResource.existing) continue;\n    if (value === undefined || RESOURCE_RESERVED_KEYS.has(key) || hasNestedResourceHandle(value)) {\n      continue;\n    }\n    userProps[key] = value;\n  }\n\n  const loweredUserProps = descriptor ? convertToArmObject(userProps, descriptor) : userProps;\n\n  for (const key of Object.keys(loweredUserProps).sort()) {\n    properties[key] = buildExpression(loweredUserProps[key] as ExpressionNodeInput, symbolMap);\n  }\n\n  return properties;\n}\n\nexport function buildResourceDeclaration(\n  resource: ResourceDeclaration,\n  symbolMap: DeclarationSymbolMap,\n): [string, ResourceDeclarationNode] {\n  const resourceId = symbolMap.get(resource);\n\n  if (resourceId === undefined) {\n    throw new Error(`Missing synthesized symbol for resource type ${resource.type}.`);\n  }\n\n  const properties = buildResourceProperties(resource, symbolMap);\n  const rawResource = unwrapResourceHandle(resource as unknown as Resource) as unknown as Record<\n    string,\n    unknown\n  >;\n\n  const condition =\n    rawResource[\"condition\"] !== undefined\n      ? buildExpression(rawResource[\"condition\"] as ExpressionNodeInput, symbolMap)\n      : undefined;\n\n  // Loop metadata lives on `LoopedResource.loop` \u2014 a public field on the\n  // wrapper subclass. Scalar `Resource` instances don't have one.\n  const loopCtx = isLoopedResource(resource) ? resource.loop : undefined;\n\n  // Build decorators for the resource (currently only batchSize from forEach)\n  const batchSize = loopCtx?.batchSize;\n  const decorators = batchSize !== undefined ? { batchSize } : undefined;\n\n  // Wrap `value` in `if-condition` / `for-expression` when the resource is\n  // guarded / looped. Bicep source order is `for` outer, `if` inner \u2014\n  // `[for item in coll: if (cond) { ... }]` \u2014 so wrap if-condition first,\n  // then for-expression around it.\n  let wireValue: DeclarableBodyNode = { kind: \"object\", value: properties };\n  if (condition !== undefined) {\n    wireValue = { kind: \"if-condition\", condition, body: wireValue };\n  }\n  if (loopCtx !== undefined) {\n    wireValue = {\n      kind: \"for-expression\",\n      itemVariable: loopCtx.itemVariable,\n      ...(loopCtx.indexVariable !== undefined ? { indexVariable: loopCtx.indexVariable } : {}),\n      collection: buildExpression(loopCtx.collection as ExpressionNodeInput, symbolMap),\n      body: wireValue,\n    };\n  }\n\n  const node: ResourceDeclarationNode = {\n    bicepIdentifier: resourceId,\n    type: resource.type,\n    apiVersion: resource.apiVersion,\n    existing: resource.existing ?? false,\n    value: wireValue,\n    ...(decorators !== undefined ? { decorators } : {}),\n  };\n\n  return [resourceId, node];\n}\n\nfunction buildDecorators(\n  decl: ParameterMetadata | VariableMetadata | OutputMetadata,\n  symbolMap: DeclarationSymbolMap,\n): DecoratorsNode | undefined {\n  const d: Record<string, unknown> = {};\n\n  if (decl.description !== undefined) d.description = decl.description;\n  if (\"secure\" in decl && decl.secure) d.secure = true;\n  if (\"minValue\" in decl && decl.minValue !== undefined) {\n    d.minValue = decl.minValue;\n  }\n  if (\"maxValue\" in decl && decl.maxValue !== undefined) {\n    d.maxValue = decl.maxValue;\n  }\n  if (\"minLength\" in decl && decl.minLength !== undefined) {\n    d.minLength = decl.minLength;\n  }\n  if (\"maxLength\" in decl && decl.maxLength !== undefined) {\n    d.maxLength = decl.maxLength;\n  }\n  if (\"metadata\" in decl && decl.metadata !== undefined) {\n    d.metadata = buildExpressionProperties(\n      decl.metadata as {\n        readonly [key: string]: ExpressionNodeInput | undefined;\n      },\n      symbolMap,\n    );\n  }\n  if (\"allowed\" in decl && decl.allowed !== undefined) {\n    d.allowed = decl.allowed.map((v) => buildExpression(v as ExpressionNodeInput, symbolMap));\n  }\n  if (\"discriminator\" in decl && decl.discriminator !== undefined) {\n    d.discriminator = decl.discriminator;\n  }\n  if (\"sealed\" in decl && decl.sealed) d.sealed = true;\n  if (\"export\" in decl && decl.export) d.export = true;\n\n  return Object.keys(d).length > 0 ? (d as DecoratorsNode) : undefined;\n}\n\nexport function buildParameterDeclarations(\n  stack: Stack,\n  symbolMap: DeclarationSymbolMap,\n): Record<string, ParameterDeclarationNode> | undefined {\n  if (stack.parameters.size === 0) return undefined;\n  return Object.fromEntries(\n    stack.parameters.listMetadata().map((p) => {\n      const identifier = symbolMap.get(p)!;\n      const node: ParameterDeclarationNode = definedProps({\n        bicepIdentifier: identifier,\n        valueType: { kind: \"primitive-type\" as const, name: p.type },\n        defaultValue:\n          p.defaultValue !== undefined\n            ? buildExpression(p.defaultValue as ExpressionNodeInput, symbolMap)\n            : undefined,\n        decorators: buildDecorators(p, symbolMap),\n      });\n      return [identifier, node];\n    }),\n  );\n}\n\nexport function buildVariableDeclarations(\n  stack: Stack,\n  symbolMap: DeclarationSymbolMap,\n): Record<string, VariableDeclarationNode> | undefined {\n  if (stack.variables.size === 0) return undefined;\n  return Object.fromEntries(\n    stack.variables.listMetadata().map((v) => {\n      const identifier = symbolMap.get(v)!;\n      const node: VariableDeclarationNode = definedProps({\n        bicepIdentifier: identifier,\n        value: buildExpression(v.value as ExpressionNodeInput, symbolMap),\n        decorators: buildDecorators(v, symbolMap),\n      });\n      return [identifier, node];\n    }),\n  );\n}\n\nexport function buildOutputDeclarations(\n  stack: Stack,\n  symbolMap: DeclarationSymbolMap,\n): Record<string, OutputDeclarationNode> | undefined {\n  if (stack.outputs.size === 0) return undefined;\n  return Object.fromEntries(\n    stack.outputs.list().map((o) => {\n      let value: ExpressionNode;\n      if (isResource(o.value)) {\n        const symbol = symbolMap.get(o.value);\n        if (symbol === undefined) {\n          throw new Error(`Resource not found in symbol map. Ensure it belongs to the same stack.`);\n        }\n\n        value = { kind: \"identifier\", id: symbol };\n      } else {\n        value = buildExpression(o.value as ExpressionNodeInput, symbolMap);\n      }\n\n      const node: OutputDeclarationNode = definedProps({\n        bicepIdentifier: o.name,\n        valueType: { kind: \"primitive-type\" as const, name: o.type },\n        value,\n        decorators: buildDecorators(o, symbolMap),\n      });\n      return [o.name, node];\n    }),\n  );\n}\n\nexport function buildStackDeclarations(\n  stack: Stack,\n  resources: readonly ResourceDeclaration[],\n  symbols: DeclarationSymbolMap,\n): Pick<InfraNode, \"parameters\" | \"variables\" | \"resources\" | \"outputs\"> {\n  return definedProps({\n    parameters: buildParameterDeclarations(stack, symbols),\n    variables: buildVariableDeclarations(stack, symbols),\n    resources:\n      resources.length === 0\n        ? undefined\n        : Object.fromEntries(\n            resources.map((resource) => buildResourceDeclaration(resource, symbols)),\n          ),\n    outputs: buildOutputDeclarations(stack, symbols),\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,4BAGO;AACP,kBAA6B;AAC7B,4BAAyB;AACzB,yBAA6B;AAC7B,uBAAiC;AACjC,4BAA6C;AAY7C,oCAIO;AACP,mCAAmC;AACnC,gCAIO;AAEP,MAAM,yBAAyB,oBAAI,IAAY;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,SAAS,wBAAwB,OAAyB;AACxD,UAAI,iCAAa,KAAK,SAAK,mCAAiB,KAAK,GAAG;AAClD,WAAO;AAAA,EACT;AAEA,UAAI,kCAAW,KAAK,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,KAAK,CAAC,SAAS,wBAAwB,IAAI,CAAC;AAAA,EAC3D;AAEA,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO,OAAO,OAAO,KAAK,EAAE,KAAK,CAAC,SAAS,wBAAwB,IAAI,CAAC;AAAA,EAC1E;AAEA,SAAO;AACT;AAEA,SAAS,wBACP,UACA,WACgC;AAChC,QAAM,kBAAc,4CAAqB,QAA+B;AACxE,QAAM,aAA6C;AAAA,IACjD,UAAM,2CAAgB,YAAY,MAAM,SAAS;AAAA,EACnD;AAEA,QAAM,gBAAY,4CAAa,QAAQ;AACvC,MAAI,cAAc,QAAW;AAC3B,UAAM,WAAW,UAAU,IAAI,SAAS;AAExC,QAAI,aAAa,QAAW;AAC1B,YAAM,IAAI,MAAM,2CAA2C,YAAY,IAAI,GAAG;AAAA,IAChF;AAEA,UAAM,aAA6B,EAAE,MAAM,cAAc,IAAI,SAAS;AAStE,UAAM,cAAe,YAAmD,wCAAkB;AAE1F,QAAI,gBAAgB,QAAW;AAC7B,iBAAW,SAAS;AAAA,QAClB,MAAM;AAAA,QACN,MAAM;AAAA,QACN,WAAO,2CAAgB,aAAoC,SAAS;AAAA,QACpE,SAAS;AAAA,QACT,SAAS;AAAA,MACX;AAAA,IACF,OAAO;AACL,iBAAW,SAAS;AAAA,IACtB;AAAA,EACF;AAGA,QAAM,iBAAa,gDAAiB,QAAQ;AAC5C,MAAI,eAAe,QAAW;AAC5B,eAAW,YAAQ,2CAAgB,YAAY,SAAS;AAAA,EAC1D,WAAW,cAAc,QAAW;AAClC,UAAM,iBAAa,wDAAyB,QAAQ;AACpD,QAAI,eAAe,QAAW;AAC5B,YAAM,UAAU,UAAU,IAAI,UAAU;AACxC,UAAI,YAAY,QAAW;AACzB,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AACA,iBAAW,QAAQ;AAAA,QACjB,MAAM;AAAA,QACN,IAAI;AAAA,MACN;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAa,YAAmD,WAAW;AAEjF,MAAI,cAAc,QAAW;AAC3B,eAAW,YAAY;AAAA,MACrB,MAAM;AAAA,MACN,OAAO,UAAU,IAAI,CAAC,eAAe;AACnC,cAAM,aAAa,UAAU,IAAI,UAAU;AAC3C,YAAI,eAAe,QAAW;AAC5B,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,QACF;AACA,eAAO,EAAE,MAAM,cAAc,IAAI,WAAW;AAAA,MAC9C,CAAC;AAAA,IACH;AAAA,EACF;AAOA,QAAM,aACJ,OAAO,YAAY,SAAS,YAAY,OAAO,YAAY,eAAe,eACtE;AAAA,IACE,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ;AAAA,EACF,IACA;AAEN,QAAM,YAAqC,CAAC;AAC5C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,WAAW,GAAG;AACtD,QAAI,YAAY,SAAU;AAC1B,QAAI,UAAU,UAAa,uBAAuB,IAAI,GAAG,KAAK,wBAAwB,KAAK,GAAG;AAC5F;AAAA,IACF;AACA,cAAU,GAAG,IAAI;AAAA,EACnB;AAEA,QAAM,mBAAmB,iBAAa,iDAAmB,WAAW,UAAU,IAAI;AAElF,aAAW,OAAO,OAAO,KAAK,gBAAgB,EAAE,KAAK,GAAG;AACtD,eAAW,GAAG,QAAI,2CAAgB,iBAAiB,GAAG,GAA0B,SAAS;AAAA,EAC3F;AAEA,SAAO;AACT;AAEO,SAAS,yBACd,UACA,WACmC;AACnC,QAAM,aAAa,UAAU,IAAI,QAAQ;AAEzC,MAAI,eAAe,QAAW;AAC5B,UAAM,IAAI,MAAM,gDAAgD,SAAS,IAAI,GAAG;AAAA,EAClF;AAEA,QAAM,aAAa,wBAAwB,UAAU,SAAS;AAC9D,QAAM,kBAAc,4CAAqB,QAA+B;AAKxE,QAAM,YACJ,YAAY,WAAW,MAAM,aACzB,2CAAgB,YAAY,WAAW,GAA0B,SAAS,IAC1E;AAIN,QAAM,cAAU,wCAAiB,QAAQ,IAAI,SAAS,OAAO;AAG7D,QAAM,YAAY,SAAS;AAC3B,QAAM,aAAa,cAAc,SAAY,EAAE,UAAU,IAAI;AAM7D,MAAI,YAAgC,EAAE,MAAM,UAAU,OAAO,WAAW;AACxE,MAAI,cAAc,QAAW;AAC3B,gBAAY,EAAE,MAAM,gBAAgB,WAAW,MAAM,UAAU;AAAA,EACjE;AACA,MAAI,YAAY,QAAW;AACzB,gBAAY;AAAA,MACV,MAAM;AAAA,MACN,cAAc,QAAQ;AAAA,MACtB,GAAI,QAAQ,kBAAkB,SAAY,EAAE,eAAe,QAAQ,cAAc,IAAI,CAAC;AAAA,MACtF,gBAAY,2CAAgB,QAAQ,YAAmC,SAAS;AAAA,MAChF,MAAM;AAAA,IACR;AAAA,EACF;AAEA,QAAM,OAAgC;AAAA,IACpC,iBAAiB;AAAA,IACjB,MAAM,SAAS;AAAA,IACf,YAAY,SAAS;AAAA,IACrB,UAAU,SAAS,YAAY;AAAA,IAC/B,OAAO;AAAA,IACP,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,EACnD;AAEA,SAAO,CAAC,YAAY,IAAI;AAC1B;AAEA,SAAS,gBACP,MACA,WAC4B;AAC5B,QAAM,IAA6B,CAAC;AAEpC,MAAI,KAAK,gBAAgB,OAAW,GAAE,cAAc,KAAK;AACzD,MAAI,YAAY,QAAQ,KAAK,OAAQ,GAAE,SAAS;AAChD,MAAI,cAAc,QAAQ,KAAK,aAAa,QAAW;AACrD,MAAE,WAAW,KAAK;AAAA,EACpB;AACA,MAAI,cAAc,QAAQ,KAAK,aAAa,QAAW;AACrD,MAAE,WAAW,KAAK;AAAA,EACpB;AACA,MAAI,eAAe,QAAQ,KAAK,cAAc,QAAW;AACvD,MAAE,YAAY,KAAK;AAAA,EACrB;AACA,MAAI,eAAe,QAAQ,KAAK,cAAc,QAAW;AACvD,MAAE,YAAY,KAAK;AAAA,EACrB;AACA,MAAI,cAAc,QAAQ,KAAK,aAAa,QAAW;AACrD,MAAE,eAAW;AAAA,MACX,KAAK;AAAA,MAGL;AAAA,IACF;AAAA,EACF;AACA,MAAI,aAAa,QAAQ,KAAK,YAAY,QAAW;AACnD,MAAE,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAM,2CAAgB,GAA0B,SAAS,CAAC;AAAA,EAC1F;AACA,MAAI,mBAAmB,QAAQ,KAAK,kBAAkB,QAAW;AAC/D,MAAE,gBAAgB,KAAK;AAAA,EACzB;AACA,MAAI,YAAY,QAAQ,KAAK,OAAQ,GAAE,SAAS;AAChD,MAAI,YAAY,QAAQ,KAAK,OAAQ,GAAE,SAAS;AAEhD,SAAO,OAAO,KAAK,CAAC,EAAE,SAAS,IAAK,IAAuB;AAC7D;AAEO,SAAS,2BACd,OACA,WACsD;AACtD,MAAI,MAAM,WAAW,SAAS,EAAG,QAAO;AACxC,SAAO,OAAO;AAAA,IACZ,MAAM,WAAW,aAAa,EAAE,IAAI,CAAC,MAAM;AACzC,YAAM,aAAa,UAAU,IAAI,CAAC;AAClC,YAAM,WAAiC,0BAAa;AAAA,QAClD,iBAAiB;AAAA,QACjB,WAAW,EAAE,MAAM,kBAA2B,MAAM,EAAE,KAAK;AAAA,QAC3D,cACE,EAAE,iBAAiB,aACf,2CAAgB,EAAE,cAAqC,SAAS,IAChE;AAAA,QACN,YAAY,gBAAgB,GAAG,SAAS;AAAA,MAC1C,CAAC;AACD,aAAO,CAAC,YAAY,IAAI;AAAA,IAC1B,CAAC;AAAA,EACH;AACF;AAEO,SAAS,0BACd,OACA,WACqD;AACrD,MAAI,MAAM,UAAU,SAAS,EAAG,QAAO;AACvC,SAAO,OAAO;AAAA,IACZ,MAAM,UAAU,aAAa,EAAE,IAAI,CAAC,MAAM;AACxC,YAAM,aAAa,UAAU,IAAI,CAAC;AAClC,YAAM,WAAgC,0BAAa;AAAA,QACjD,iBAAiB;AAAA,QACjB,WAAO,2CAAgB,EAAE,OAA8B,SAAS;AAAA,QAChE,YAAY,gBAAgB,GAAG,SAAS;AAAA,MAC1C,CAAC;AACD,aAAO,CAAC,YAAY,IAAI;AAAA,IAC1B,CAAC;AAAA,EACH;AACF;AAEO,SAAS,wBACd,OACA,WACmD;AACnD,MAAI,MAAM,QAAQ,SAAS,EAAG,QAAO;AACrC,SAAO,OAAO;AAAA,IACZ,MAAM,QAAQ,KAAK,EAAE,IAAI,CAAC,MAAM;AAC9B,UAAI;AACJ,cAAI,kCAAW,EAAE,KAAK,GAAG;AACvB,cAAM,SAAS,UAAU,IAAI,EAAE,KAAK;AACpC,YAAI,WAAW,QAAW;AACxB,gBAAM,IAAI,MAAM,wEAAwE;AAAA,QAC1F;AAEA,gBAAQ,EAAE,MAAM,cAAc,IAAI,OAAO;AAAA,MAC3C,OAAO;AACL,oBAAQ,2CAAgB,EAAE,OAA8B,SAAS;AAAA,MACnE;AAEA,YAAM,WAA8B,0BAAa;AAAA,QAC/C,iBAAiB,EAAE;AAAA,QACnB,WAAW,EAAE,MAAM,kBAA2B,MAAM,EAAE,KAAK;AAAA,QAC3D;AAAA,QACA,YAAY,gBAAgB,GAAG,SAAS;AAAA,MAC1C,CAAC;AACD,aAAO,CAAC,EAAE,MAAM,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AACF;AAEO,SAAS,uBACd,OACA,WACA,SACuE;AACvE,aAAO,0BAAa;AAAA,IAClB,YAAY,2BAA2B,OAAO,OAAO;AAAA,IACrD,WAAW,0BAA0B,OAAO,OAAO;AAAA,IACnD,WACE,UAAU,WAAW,IACjB,SACA,OAAO;AAAA,MACL,UAAU,IAAI,CAAC,aAAa,yBAAyB,UAAU,OAAO,CAAC;AAAA,IACzE;AAAA,IACN,SAAS,wBAAwB,OAAO,OAAO;AAAA,EACjD,CAAC;AACH;",
+  "names": []
+}

package/dist/commonjs/serialization/ast/declaration-dependencies.d.ts

@@ -0,0 +1,18 @@
+import type { AstDeclarationMap, DeclarationNode } from "./index.js";
+export type DeclarationDependencyOptions = {
+    readonly recursive?: false;
+} | {
+    readonly recursive: true;
+    /** Only references present in this emitted-identifier map are followed. */
+    readonly declarations: AstDeclarationMap;
+};
+/**
+ * Collects names referenced by declaration values/defaults, types, and decorators,
+ * excluding loop-local identifiers. These are dependencies of the declarations,
+ * not declarations that depend on them. By default, only direct names are collected.
+ * Recursive mode follows references through the declaration map using a work queue.
+ * Each declaration instance is inspected once per call, so cycles terminate without
+ * being validated. Names with no resolved declaration remain in the result.
+ */
+export declare function collectDependenciesForDeclaration(input: DeclarationNode | readonly DeclarationNode[], options?: DeclarationDependencyOptions): Set<string>;
+//# sourceMappingURL=declaration-dependencies.d.ts.map

package/dist/commonjs/serialization/ast/declaration-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration-dependencies.d.ts","sourceRoot":"","sources":["../../../../src/serialization/ast/declaration-dependencies.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAY,MAAM,YAAY,CAAC;AAG/E,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAA;CAAE,GAC9B;IACE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,EACnD,OAAO,CAAC,EAAE,4BAA4B,GACrC,GAAG,CAAC,MAAM,CAAC,CAkBb"}

package/dist/commonjs/serialization/ast/declaration-dependencies.js

@@ -0,0 +1,109 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var declaration_dependencies_exports = {};
+__export(declaration_dependencies_exports, {
+  collectDependenciesForDeclaration: () => collectDependenciesForDeclaration
+});
+module.exports = __toCommonJS(declaration_dependencies_exports);
+var import_expression_walker = require("./expression-walker.js");
+function collectDependenciesForDeclaration(input, options) {
+  const identifiers = /* @__PURE__ */ new Set();
+  const visited = /* @__PURE__ */ new Set();
+  const pending = "bicepIdentifier" in input ? [input] : [...input];
+  for (let index = 0; index < pending.length; index++) {
+    const declaration = pending[index];
+    if (visited.has(declaration)) continue;
+    visited.add(declaration);
+    for (const identifier of collectDirectDependencies(declaration)) {
+      if (identifiers.has(identifier)) continue;
+      identifiers.add(identifier);
+      if (options?.recursive === true) {
+        const dependency = options.declarations.get(identifier);
+        if (dependency !== void 0) pending.push(dependency);
+      }
+    }
+  }
+  return identifiers;
+}
+function collectDirectDependencies(node) {
+  const identifiers = /* @__PURE__ */ new Set();
+  if ("valueType" in node) {
+    collectIdentifierIdsFromType(node.valueType, identifiers);
+  }
+  (0, import_expression_walker.walkDeclarationExpressions)(node, (expression, boundIdentifiers) => {
+    if (expression.kind === "identifier" && !boundIdentifiers.has(expression.id)) {
+      identifiers.add(expression.id);
+    }
+  });
+  return identifiers;
+}
+function collectIdentifierIdsFromType(type, identifiers) {
+  switch (type.kind) {
+    case "type-reference":
+      identifiers.add(type.name);
+      return;
+    case "union-type-member":
+    case "parameterized-type-argument":
+      collectIdentifierIdsFromType(type.valueType, identifiers);
+      return;
+    case "array-type":
+      collectIdentifierIdsFromType(type.item, identifiers);
+      return;
+    case "object-type-property":
+    case "object-type-additional-properties":
+      collectIdentifierIdsFromType(type.valueType, identifiers);
+      return;
+    case "object-type":
+      for (const property of type.properties) {
+        collectIdentifierIdsFromType(property, identifiers);
+      }
+      if (type.additionalProperties !== void 0) {
+        collectIdentifierIdsFromType(type.additionalProperties, identifiers);
+      }
+      return;
+    case "union-type":
+      for (const member of type.members) {
+        collectIdentifierIdsFromType(member.valueType, identifiers);
+      }
+      return;
+    case "nullable-type":
+      collectIdentifierIdsFromType(type.base, identifiers);
+      return;
+    case "parameterized-type-instantiation":
+      collectIdentifierIdsFromType(type.base, identifiers);
+      for (const argument of type.args) {
+        collectIdentifierIdsFromType(argument.valueType, identifiers);
+      }
+      return;
+    case "primitive-type":
+    case "string-type-literal":
+    case "integer-type-literal":
+    case "boolean-type-literal":
+    case "null-type-literal":
+      return;
+    default: {
+      const exhaustive = type;
+      throw new Error(`Unsupported type kind: ${exhaustive.kind}`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  collectDependenciesForDeclaration
+});
+//# sourceMappingURL=declaration-dependencies.js.map

package/dist/commonjs/serialization/ast/declaration-dependencies.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/serialization/ast/declaration-dependencies.ts"],
+  "sourcesContent": ["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport type { AstDeclarationMap, DeclarationNode, TypeNode } from \"./index.js\";\nimport { walkDeclarationExpressions } from \"./expression-walker.js\";\n\nexport type DeclarationDependencyOptions =\n  | { readonly recursive?: false }\n  | {\n      readonly recursive: true;\n      /** Only references present in this emitted-identifier map are followed. */\n      readonly declarations: AstDeclarationMap;\n    };\n\n/**\n * Collects names referenced by declaration values/defaults, types, and decorators,\n * excluding loop-local identifiers. These are dependencies of the declarations,\n * not declarations that depend on them. By default, only direct names are collected.\n * Recursive mode follows references through the declaration map using a work queue.\n * Each declaration instance is inspected once per call, so cycles terminate without\n * being validated. Names with no resolved declaration remain in the result.\n */\nexport function collectDependenciesForDeclaration(\n  input: DeclarationNode | readonly DeclarationNode[],\n  options?: DeclarationDependencyOptions,\n): Set<string> {\n  const identifiers = new Set<string>();\n  const visited = new Set<DeclarationNode>();\n  const pending = \"bicepIdentifier\" in input ? [input] : [...input];\n  for (let index = 0; index < pending.length; index++) {\n    const declaration = pending[index]!;\n    if (visited.has(declaration)) continue;\n    visited.add(declaration);\n    for (const identifier of collectDirectDependencies(declaration)) {\n      if (identifiers.has(identifier)) continue;\n      identifiers.add(identifier);\n      if (options?.recursive === true) {\n        const dependency = options.declarations.get(identifier);\n        if (dependency !== undefined) pending.push(dependency);\n      }\n    }\n  }\n  return identifiers;\n}\n\nfunction collectDirectDependencies(node: DeclarationNode): Set<string> {\n  const identifiers = new Set<string>();\n  if (\"valueType\" in node) {\n    collectIdentifierIdsFromType(node.valueType, identifiers);\n  }\n  walkDeclarationExpressions(node, (expression, boundIdentifiers) => {\n    if (expression.kind === \"identifier\" && !boundIdentifiers.has(expression.id)) {\n      identifiers.add(expression.id);\n    }\n  });\n  return identifiers;\n}\n\nfunction collectIdentifierIdsFromType(type: TypeNode, identifiers: Set<string>): void {\n  switch (type.kind) {\n    case \"type-reference\":\n      identifiers.add(type.name);\n      return;\n    case \"union-type-member\":\n    case \"parameterized-type-argument\":\n      collectIdentifierIdsFromType(type.valueType, identifiers);\n      return;\n    case \"array-type\":\n      collectIdentifierIdsFromType(type.item, identifiers);\n      return;\n    case \"object-type-property\":\n    case \"object-type-additional-properties\":\n      collectIdentifierIdsFromType(type.valueType, identifiers);\n      return;\n    case \"object-type\":\n      for (const property of type.properties) {\n        collectIdentifierIdsFromType(property, identifiers);\n      }\n      if (type.additionalProperties !== undefined) {\n        collectIdentifierIdsFromType(type.additionalProperties, identifiers);\n      }\n      return;\n    case \"union-type\":\n      for (const member of type.members) {\n        collectIdentifierIdsFromType(member.valueType, identifiers);\n      }\n      return;\n    case \"nullable-type\":\n      collectIdentifierIdsFromType(type.base, identifiers);\n      return;\n    case \"parameterized-type-instantiation\":\n      collectIdentifierIdsFromType(type.base, identifiers);\n      for (const argument of type.args) {\n        collectIdentifierIdsFromType(argument.valueType, identifiers);\n      }\n      return;\n    case \"primitive-type\":\n    case \"string-type-literal\":\n    case \"integer-type-literal\":\n    case \"boolean-type-literal\":\n    case \"null-type-literal\":\n      return;\n    default: {\n      const exhaustive: never = type;\n      throw new Error(`Unsupported type kind: ${(exhaustive as { kind: string }).kind}`);\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,+BAA2C;AAkBpC,SAAS,kCACd,OACA,SACa;AACb,QAAM,cAAc,oBAAI,IAAY;AACpC,QAAM,UAAU,oBAAI,IAAqB;AACzC,QAAM,UAAU,qBAAqB,QAAQ,CAAC,KAAK,IAAI,CAAC,GAAG,KAAK;AAChE,WAAS,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS;AACnD,UAAM,cAAc,QAAQ,KAAK;AACjC,QAAI,QAAQ,IAAI,WAAW,EAAG;AAC9B,YAAQ,IAAI,WAAW;AACvB,eAAW,cAAc,0BAA0B,WAAW,GAAG;AAC/D,UAAI,YAAY,IAAI,UAAU,EAAG;AACjC,kBAAY,IAAI,UAAU;AAC1B,UAAI,SAAS,cAAc,MAAM;AAC/B,cAAM,aAAa,QAAQ,aAAa,IAAI,UAAU;AACtD,YAAI,eAAe,OAAW,SAAQ,KAAK,UAAU;AAAA,MACvD;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,0BAA0B,MAAoC;AACrE,QAAM,cAAc,oBAAI,IAAY;AACpC,MAAI,eAAe,MAAM;AACvB,iCAA6B,KAAK,WAAW,WAAW;AAAA,EAC1D;AACA,2DAA2B,MAAM,CAAC,YAAY,qBAAqB;AACjE,QAAI,WAAW,SAAS,gBAAgB,CAAC,iBAAiB,IAAI,WAAW,EAAE,GAAG;AAC5E,kBAAY,IAAI,WAAW,EAAE;AAAA,IAC/B;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAEA,SAAS,6BAA6B,MAAgB,aAAgC;AACpF,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,kBAAY,IAAI,KAAK,IAAI;AACzB;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,mCAA6B,KAAK,WAAW,WAAW;AACxD;AAAA,IACF,KAAK;AACH,mCAA6B,KAAK,MAAM,WAAW;AACnD;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AACH,mCAA6B,KAAK,WAAW,WAAW;AACxD;AAAA,IACF,KAAK;AACH,iBAAW,YAAY,KAAK,YAAY;AACtC,qCAA6B,UAAU,WAAW;AAAA,MACpD;AACA,UAAI,KAAK,yBAAyB,QAAW;AAC3C,qCAA6B,KAAK,sBAAsB,WAAW;AAAA,MACrE;AACA;AAAA,IACF,KAAK;AACH,iBAAW,UAAU,KAAK,SAAS;AACjC,qCAA6B,OAAO,WAAW,WAAW;AAAA,MAC5D;AACA;AAAA,IACF,KAAK;AACH,mCAA6B,KAAK,MAAM,WAAW;AACnD;AAAA,IACF,KAAK;AACH,mCAA6B,KAAK,MAAM,WAAW;AACnD,iBAAW,YAAY,KAAK,MAAM;AAChC,qCAA6B,SAAS,WAAW,WAAW;AAAA,MAC9D;AACA;AAAA,IACF,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH;AAAA,IACF,SAAS;AACP,YAAM,aAAoB;AAC1B,YAAM,IAAI,MAAM,0BAA2B,WAAgC,IAAI,EAAE;AAAA,IACnF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/commonjs/serialization/ast/expression-builder.d.ts

@@ -0,0 +1,14 @@
+import { type ExpressionNode as CoreExpressionNode } from "../../expression/ast-nodes.js";
+import { type Expression } from "../../expression/expressions.js";
+import type { DeclarationSymbolMap } from "../symbol-map.js";
+import type { ExpressionNode } from "./index.js";
+export type ExpressionNodeInput = CoreExpressionNode | Expression<unknown> | string | number | boolean | null | readonly ExpressionNodeInput[] | {
+    readonly [key: string]: ExpressionNodeInput | undefined;
+};
+/** Builds a property map of expression nodes, omitting undefined values. */
+export declare function buildExpressionProperties(value: {
+    readonly [key: string]: ExpressionNodeInput | undefined;
+}, symbolMap: DeclarationSymbolMap): Record<string, ExpressionNode>;
+export declare function moduleOutputExpression(moduleName: string, outputName: string): ExpressionNode;
+export declare function buildExpression(value: ExpressionNodeInput, symbolMap?: DeclarationSymbolMap): ExpressionNode;
+//# sourceMappingURL=expression-builder.d.ts.map

package/dist/commonjs/serialization/ast/expression-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-builder.d.ts","sourceRoot":"","sources":["../../../../src/serialization/ast/expression-builder.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,cAAc,IAAI,kBAAkB,EAG1C,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAc,cAAc,EAAuC,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,UAAU,CAAC,OAAO,CAAC,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,mBAAmB,EAAE,GAC9B;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CACzD,CAAC;AA6HN,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;CAAE,EAClE,SAAS,EAAE,oBAAoB,GAC9B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAMhC;AA4GD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAY7F;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,GAAE,oBAAgC,GAC1C,cAAc,CA6HhB"}