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

package/dist/esm/constructs/resource/resource-query.d.ts

@@ -1,5 +1,5 @@
 import type { ProvisioningComponent } from "../provisioning-component.js";
-import type { LoopedResource, Resource } from "./resource.js";
+import type { LoopedResource, Resource, ResourceDeclaration } from "./resource.js";
 import type { ResourceCtor } from "./resource-registry.js";
 /** Options accepted by the `Stack` resource queries. */
 export interface QueryOptions {
@@ -9,6 +9,8 @@ export interface QueryOptions {
      */
     readonly recursive?: boolean;
 }
+/** All scalar and looped declarations in tree order, including a resource root. */
+export declare function collectResourceDeclarations(root: ProvisioningComponent): ResourceDeclaration[];
 /** Scalar (un-looped) resource declarations. */
 export declare function getResources(root: ProvisioningComponent, typeOrOptions?: ResourceCtor<Resource> | QueryOptions, maybeOptions?: QueryOptions): Resource[];
 /** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */

package/dist/esm/constructs/resource/resource-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-query.d.ts","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAsCD,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,QAAQ,EAAE,CAOZ;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,cAAc,CAAC,QAAQ,CAAC,EAAE,CAO5B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,CAAC,GAAG,SAAS,CAKf"}
+{"version":3,"file":"resource-query.d.ts","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAsCD,mFAAmF;AACnF,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,qBAAqB,GAAG,mBAAmB,EAAE,CAQ9F;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,QAAQ,EAAE,CAOZ;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,qBAAqB,EAC3B,aAAa,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,YAAY,EACrD,YAAY,CAAC,EAAE,YAAY,GAC1B,cAAc,CAAC,QAAQ,CAAC,EAAE,CAO5B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,GACrB,CAAC,GAAG,SAAS,CAKf"}

package/dist/esm/constructs/resource/resource-query.js

@@ -35,6 +35,16 @@ function collectResourcesUnder(root, wantLooped, recursive) {
 // Engine entry points — thin, loosely-typed; `Stack` supplies the public
 // typed overloads and delegates here.
 // ---------------------------------------------------------------------------
+/** All scalar and looped declarations in tree order, including a resource root. */
+export function collectResourceDeclarations(root) {
+    const result = [];
+    root.visit((node) => {
+        if (isResourceDeclaration(node)) {
+            result.push(node.self);
+        }
+    });
+    return result;
+}
 /** Scalar (un-looped) resource declarations. */
 export function getResources(root, typeOrOptions, maybeOptions) {
     const isCtor = typeof typeOrOptions === "function";

package/dist/esm/constructs/resource/resource-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-query.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-query.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { isResourceDeclaration, isLoopedResource, isLoopedResourceOf } from \"./resource-utils.js\";\nimport { deref } from \"./resource-proxy.js\";\nimport type { ProvisioningComponent } from \"../provisioning-component.js\";\nimport type { LoopedResource, Resource } from \"./resource.js\";\nimport type { ResourceCtor } from \"./resource-registry.js\";\n\n// ---------------------------------------------------------------------------\n// Query result types\n// ---------------------------------------------------------------------------\n\n/** Options accepted by the `Stack` resource queries. */\nexport interface QueryOptions {\n  /**\n   * Whether to walk the stack's entire subtree (default `true`) or only its\n   * **direct children** (`false`).\n   */\n  readonly recursive?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Query engine (module-private)\n// ---------------------------------------------------------------------------\n// Imports only brand guards (`resource-utils`) — which do not import\n// `ProvisioningComponent`/`Stack` at runtime — plus types (type-only), so there is no\n// import cycle.\n\n/**\n * Collect the resource declarations beneath `root` (the root itself is never\n * included). `recursive` descends the whole subtree via `visit`; otherwise\n * only `root`'s direct children are considered. `wantLooped` selects the\n * looped declarations (`Ctor.fromLoop(...)`) vs. the scalar ones.\n */\nfunction collectResourcesUnder(\n  root: ProvisioningComponent,\n  wantLooped: boolean,\n  recursive: boolean,\n): (Resource | LoopedResource<Resource>)[] {\n  const result: (Resource | LoopedResource<Resource>)[] = [];\n  const consider = (node: ProvisioningComponent): void => {\n    if (!isResourceDeclaration(node)) return;\n    const r = node.self as Resource | LoopedResource<Resource>;\n    if (isLoopedResource(r) === wantLooped) result.push(r);\n  };\n  for (const child of root.children) {\n    if (recursive) child.visit(consider);\n    else consider(child);\n  }\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Engine entry points — thin, loosely-typed; `Stack` supplies the public\n// typed overloads and delegates here.\n// ---------------------------------------------------------------------------\n\n/** Scalar (un-looped) resource declarations. */\nexport function getResources(\n  root: ProvisioningComponent,\n  typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n  maybeOptions?: QueryOptions,\n): Resource[] {\n  const isCtor = typeof typeOrOptions === \"function\";\n  const type = isCtor ? (typeOrOptions as ResourceCtor<Resource>) : undefined;\n  const options = (isCtor ? maybeOptions : typeOrOptions) as QueryOptions | undefined;\n  const recursive = options?.recursive ?? true;\n  const found = collectResourcesUnder(root, false, recursive) as Resource[];\n  return type === undefined ? found : found.filter((r) => r instanceof type);\n}\n\n/** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */\nexport function getLoopedResources(\n  root: ProvisioningComponent,\n  typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n  maybeOptions?: QueryOptions,\n): LoopedResource<Resource>[] {\n  const isCtor = typeof typeOrOptions === \"function\";\n  const type = isCtor ? (typeOrOptions as ResourceCtor<Resource>) : undefined;\n  const options = (isCtor ? maybeOptions : typeOrOptions) as QueryOptions | undefined;\n  const recursive = options?.recursive ?? true;\n  const found = collectResourcesUnder(root, true, recursive) as LoopedResource<Resource>[];\n  return type === undefined ? found : found.filter((r) => isLoopedResourceOf(r, type));\n}\n\n/**\n * First scalar resource of `type` whose literal name equals `name`, or\n * `undefined`. `deref` resolves the name's expression proxy to its literal\n * (a `Resource`'s `name` is an `Expression`, so `r.name === name` is always\n * false without it).\n */\nexport function getResource<T extends Resource>(\n  root: ProvisioningComponent,\n  type: ResourceCtor<T>,\n  name: string,\n  options?: QueryOptions,\n): T | undefined {\n  for (const r of getResources(root, type, options)) {\n    if (deref((r as Resource).name) === name) return r as T;\n  }\n  return undefined;\n}\n"]}
+{"version":3,"file":"resource-query.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-query.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport { isResourceDeclaration, isLoopedResource, isLoopedResourceOf } from \"./resource-utils.js\";\nimport { deref } from \"./resource-proxy.js\";\nimport type { ProvisioningComponent } from \"../provisioning-component.js\";\nimport type { LoopedResource, Resource, ResourceDeclaration } from \"./resource.js\";\nimport type { ResourceCtor } from \"./resource-registry.js\";\n\n// ---------------------------------------------------------------------------\n// Query result types\n// ---------------------------------------------------------------------------\n\n/** Options accepted by the `Stack` resource queries. */\nexport interface QueryOptions {\n  /**\n   * Whether to walk the stack's entire subtree (default `true`) or only its\n   * **direct children** (`false`).\n   */\n  readonly recursive?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Query engine (module-private)\n// ---------------------------------------------------------------------------\n// Imports only brand guards (`resource-utils`) — which do not import\n// `ProvisioningComponent`/`Stack` at runtime — plus types (type-only), so there is no\n// import cycle.\n\n/**\n * Collect the resource declarations beneath `root` (the root itself is never\n * included). `recursive` descends the whole subtree via `visit`; otherwise\n * only `root`'s direct children are considered. `wantLooped` selects the\n * looped declarations (`Ctor.fromLoop(...)`) vs. the scalar ones.\n */\nfunction collectResourcesUnder(\n  root: ProvisioningComponent,\n  wantLooped: boolean,\n  recursive: boolean,\n): (Resource | LoopedResource<Resource>)[] {\n  const result: (Resource | LoopedResource<Resource>)[] = [];\n  const consider = (node: ProvisioningComponent): void => {\n    if (!isResourceDeclaration(node)) return;\n    const r = node.self as Resource | LoopedResource<Resource>;\n    if (isLoopedResource(r) === wantLooped) result.push(r);\n  };\n  for (const child of root.children) {\n    if (recursive) child.visit(consider);\n    else consider(child);\n  }\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Engine entry points — thin, loosely-typed; `Stack` supplies the public\n// typed overloads and delegates here.\n// ---------------------------------------------------------------------------\n\n/** All scalar and looped declarations in tree order, including a resource root. */\nexport function collectResourceDeclarations(root: ProvisioningComponent): ResourceDeclaration[] {\n  const result: ResourceDeclaration[] = [];\n  root.visit((node) => {\n    if (isResourceDeclaration(node)) {\n      result.push(node.self);\n    }\n  });\n  return result;\n}\n\n/** Scalar (un-looped) resource declarations. */\nexport function getResources(\n  root: ProvisioningComponent,\n  typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n  maybeOptions?: QueryOptions,\n): Resource[] {\n  const isCtor = typeof typeOrOptions === \"function\";\n  const type = isCtor ? (typeOrOptions as ResourceCtor<Resource>) : undefined;\n  const options = (isCtor ? maybeOptions : typeOrOptions) as QueryOptions | undefined;\n  const recursive = options?.recursive ?? true;\n  const found = collectResourcesUnder(root, false, recursive) as Resource[];\n  return type === undefined ? found : found.filter((r) => r instanceof type);\n}\n\n/** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */\nexport function getLoopedResources(\n  root: ProvisioningComponent,\n  typeOrOptions?: ResourceCtor<Resource> | QueryOptions,\n  maybeOptions?: QueryOptions,\n): LoopedResource<Resource>[] {\n  const isCtor = typeof typeOrOptions === \"function\";\n  const type = isCtor ? (typeOrOptions as ResourceCtor<Resource>) : undefined;\n  const options = (isCtor ? maybeOptions : typeOrOptions) as QueryOptions | undefined;\n  const recursive = options?.recursive ?? true;\n  const found = collectResourcesUnder(root, true, recursive) as LoopedResource<Resource>[];\n  return type === undefined ? found : found.filter((r) => isLoopedResourceOf(r, type));\n}\n\n/**\n * First scalar resource of `type` whose literal name equals `name`, or\n * `undefined`. `deref` resolves the name's expression proxy to its literal\n * (a `Resource`'s `name` is an `Expression`, so `r.name === name` is always\n * false without it).\n */\nexport function getResource<T extends Resource>(\n  root: ProvisioningComponent,\n  type: ResourceCtor<T>,\n  name: string,\n  options?: QueryOptions,\n): T | undefined {\n  for (const r of getResources(root, type, options)) {\n    if (deref((r as Resource).name) === name) return r as T;\n  }\n  return undefined;\n}\n"]}

package/dist/esm/constructs/resource/resource-relationships.d.ts

@@ -0,0 +1,9 @@
+import type { ResourceDeclaration } from "./resource.js";
+import { type ExpressionNode } from "../../expression/ast-nodes.js";
+/** Finds the nearest resource parent, excluding resource-group containment. */
+export declare function getArmParent(resource: ResourceDeclaration): ResourceDeclaration | undefined;
+/** Finds the resource group containing the authored resource. */
+export declare function getResourceGroupAncestor(resource: ResourceDeclaration): ResourceDeclaration | undefined;
+/** Reads an explicit scope expression without creating a resource-property reference. */
+export declare function getResourceScope(resource: ResourceDeclaration): ExpressionNode | undefined;
+//# sourceMappingURL=resource-relationships.d.ts.map

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

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

package/dist/esm/constructs/resource/resource-relationships.js

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { ResourceGroup } from "../built-in-resources/resource-group.js";
+import { unwrapResourceHandle } from "./resource-proxy.js";
+import { isResourceDeclaration } from "./resource-utils.js";
+import { isExpressionNode } from "../../expression/ast-nodes.js";
+/** Finds the nearest resource parent, excluding resource-group containment. */
+export function getArmParent(resource) {
+    for (let parent = resource.parent; parent !== undefined; parent = parent.parent) {
+        if (isResourceDeclaration(parent)) {
+            return parent.type === ResourceGroup.resourceType ? undefined : parent.self;
+        }
+    }
+    return undefined;
+}
+/** Finds the resource group containing the authored resource. */
+export function getResourceGroupAncestor(resource) {
+    for (let current = resource.parent; current !== undefined; current = current.parent) {
+        if (isResourceDeclaration(current) && current.type === ResourceGroup.resourceType) {
+            return current.self;
+        }
+    }
+    return undefined;
+}
+/** Reads an explicit scope expression without creating a resource-property reference. */
+export function getResourceScope(resource) {
+    const scope = Reflect.get(unwrapResourceHandle(resource), "scope");
+    if (scope === undefined)
+        return undefined;
+    if (!isExpressionNode(scope)) {
+        throw new Error(`Invalid authored scope for resource "${resource.type}".`);
+    }
+    return scope;
+}
+//# sourceMappingURL=resource-relationships.js.map

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

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

package/dist/esm/constructs/resource/resource.d.ts

@@ -31,21 +31,12 @@ export interface ResourceState<TType extends string = string> {
     readonly apiVersion: string;
     readonly existing?: boolean | undefined;
     /**
-     * Optional Bicep `scope:` expression. Currently emitted only on `existing`
-     * resource references (e.g. `scope: resourceGroup('shared')` for a
-     * cross-RG lookup). Future scope-hoisted resource types may emit it on
-     * deployable resources too — for example, deploying a
-     * `Microsoft.Management/managementGroups` from a subscription-targeted
-     * file requires `scope: tenant()`. See `contributing/bicep/bicep-scope.md` section 2.2.
+     * Explicit scope expression. Authoring populates this for existing-resource
+     * lookups; restoration can retain uninterpreted scope expressions on any
+     * declaration. Expressions are normalized to raw nodes.
      *
-     * For ordinary deployable resources this field is `undefined` — their
-     * deployment scope is determined by the file's `targetScope` (or by the
-     * containing `ResourceGroup` / module the resource lives in).
-     *
-     * Stored as a raw `ExpressionNode` (the user-facing `ScopeExpression`
-     * proxy is unwrapped at the constructor boundary, matching the
-     * "`state` holds normalized raw nodes" invariant that
-     * `normalizeAssignedValue` maintains for every other field).
+     * New-resource authoring still derives placement from the Stack and parent
+     * context rather than accepting an explicit scope override.
      */
     readonly scope?: ExpressionNode | undefined;
     readonly condition?: ExpressionOrValue<boolean> | undefined;
@@ -63,9 +54,9 @@ export interface ResourceState<TType extends string = string> {
  * resource as the ProvisioningComponent `context` argument to the resource constructor
  * (with `{ existing: true }`), not via this `scope` field.
  */
-export interface ExistingResourceProps {
+export interface ExistingResourceProps<TName extends string = string> {
     /** Required. The actual Azure name of the existing resource. */
-    readonly name: ExpressionOrValue<string>;
+    readonly name: ExpressionOrValue<TName>;
     /**
      * Optional. The scope at which to look up the resource. Used when the
      * resource lives outside the current deployment's scope (different RG,
@@ -144,6 +135,7 @@ export interface ResourceOptions {
  * access behavior.
  */
 export declare abstract class ResourceDeclaration<TType extends string = string> extends ProvisioningComponent {
+    protected readonly namingRules: ResourceNamingRules | undefined;
     /**
      * Brand marker for cross-realm `isResourceDeclaration()` checks. Uses
      * `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.
@@ -288,13 +280,15 @@ export declare class Resource<TType extends string = string> extends ResourceDec
      * Per-resource-type naming constraints, consumed by the active
      * {@link NamingPolicy} when a resource is created without an explicit
      * `name`. Generated CDK subclasses override this with a concrete value;
-     * the base default of `undefined` yields `MOST_RESTRICTIVE` behavior.
+     * the base default of `undefined` uses the default naming convention.
      *
      * This is type metadata, not user input, so it is kept off the public
      * props surface and read reflectively in the constructor via
      * `this.constructor` rather than being threaded through `ResourceProps`.
      */
     protected static namingRules?: ResourceNamingRules;
+    /** Validates construction inputs before a scalar or looped declaration is registered. */
+    protected static validate(_context: ProvisioningComponent, _props: ResourceProps<string> & Record<string, unknown>, _options?: ResourceOptions, _namingRules?: ResourceNamingRules): void;
     protected _selfProxy: this | undefined;
     constructor(context: ProvisioningComponent, props: ResourceProps<TType> & Record<string, unknown>, options?: ResourceOptions);
     get self(): this;

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

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

package/dist/esm/constructs/resource/resource.js

@@ -3,7 +3,8 @@
 import { ProvisioningComponent } from "../provisioning-component.js";
 import { createBinaryExpression, unwrapExpression, wrapExpression, } from "../../expression/expressions.js";
 import { symbolicValueExpressionNode } from "../../expression/ast-nodes.js";
-import { namingRequiredPolicy, resolveResourceName } from "../../naming/naming-policy.js";
+import { assertValidResourceName } from "../../naming/name-validation.js";
+import { namingRequiredPolicy, generateResourceName } from "../../naming/naming-policy.js";
 import { RAW_RESOURCE_HANDLE, RESOURCE_BRAND, RESOURCE_DECLARATION_BRAND, LOOPED_RESOURCE_BRAND, PROXY_INDEX_REF, INDEXED_PROXY_TARGET, STATE_PARENT_INDEX, createIndexedResourceProxy, createResourceMemberProxy, createResourceProxy, normalizeAssignedValue, unwrapResourceHandle, } from "./resource-proxy.js";
 import { isResourceDeclaration } from "./resource-utils.js";
 import { getShape, registerShape as registerShapeInRegistry } from "../../shape/shape-registry.js";
@@ -24,6 +25,7 @@ import { registerResource as registerResourceInRegistry, } from "./resource-regi
  * access behavior.
  */
 export class ResourceDeclaration extends ProvisioningComponent {
+    namingRules;
     /**
      * Brand marker for cross-realm `isResourceDeclaration()` checks. Uses
      * `Symbol.for` so it survives multiple copies of `@azure/provisioning-core`.
@@ -62,7 +64,20 @@ export class ResourceDeclaration extends ProvisioningComponent {
      *   the concrete resource constructor they represent.
      */
     constructor(context, props, options, namingRules) {
+        const armParent = isResourceDeclaration(context) &&
+            props.type.toLowerCase().startsWith(context.type.toLowerCase() + "/")
+            ? context
+            : undefined;
+        // Automatic naming uses the authored rather than the discovered hierarchy.
+        const nameSegments = namingRules !== undefined &&
+            (armParent !== undefined || namingRules.nameSegments !== undefined)
+            ? props.type.split("/").length - (armParent?.type.split("/").length ?? 1)
+            : undefined;
+        if (props.name !== undefined) {
+            assertValidResourceName(props.name, props.type, namingRules);
+        }
         super(context);
+        this.namingRules = namingRules;
         if (!this.hasDeploymentContext()) {
             throw new Error("Resource declaration must have a parent deployment context.");
         }
@@ -94,14 +109,15 @@ export class ResourceDeclaration extends ProvisioningComponent {
         //
         // Bicep requires a child of a conditional resource to itself be
         // conditional on the same expression. When no explicit `condition` is
-        // supplied, inherit the immediate parent resource declaration's
+        // supplied, inherit the nearest parent resource declaration's
         // condition so the emitted template stays valid — child authoring
         // shouldn't have to redundantly restate the parent's guard.
         const isExisting = props.existing === true;
-        const parent = this.parent;
-        const inheritedCondition = isResourceDeclaration(parent)
-            ? parent.self.state["condition"]
-            : undefined;
+        let parent = this.parent;
+        while (parent !== undefined && !isResourceDeclaration(parent)) {
+            parent = parent.parent;
+        }
+        const inheritedCondition = isResourceDeclaration(parent) ? parent.condition : undefined;
         const explicitCondition = options?.condition;
         const condition = explicitCondition !== undefined && inheritedCondition !== undefined
             ? createBinaryExpression("&&", inheritedCondition, explicitCondition)
@@ -135,8 +151,22 @@ export class ResourceDeclaration extends ProvisioningComponent {
             // authored property.
             const { name: _name, type: _type, apiVersion: _apiVersion, existing: _existing, scope: _scope, ...userProps } = props;
             const ctx = this.deploymentContext;
+            let resolvedName;
+            try {
+                resolvedName =
+                    props.name ??
+                        generateResourceName(ctx.namingPolicy ?? namingRequiredPolicy, props.type, namingRules, nameSegments);
+            }
+            catch (error) {
+                // A rejected generated name must not leave a partial declaration
+                // registered in its parent's tree.
+                const index = this.parent?.children.indexOf(this) ?? -1;
+                if (index >= 0)
+                    this.parent.children.splice(index, 1);
+                throw error;
+            }
             data = {
-                name: resolveResourceName(ctx.namingPolicy ?? namingRequiredPolicy, props.name, props.type, namingRules),
+                name: resolvedName,
                 type: props.type,
                 apiVersion: props.apiVersion,
                 condition,
@@ -157,20 +187,27 @@ export class ResourceDeclaration extends ProvisioningComponent {
             // replace inherited tags).
             const shape = getShape(props.type, props.apiVersion, data);
             if (shape !== undefined) {
-                const locationShape = shape.byJsName["location"];
-                if (locationShape !== undefined &&
+                const properties = Object.entries(shape.byJsName);
+                const locationProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === "location");
+                const locationName = locationProperty?.[0];
+                const locationShape = locationProperty?.[1];
+                if (locationName !== undefined &&
+                    locationShape !== undefined &&
                     locationShape.readOnly !== true &&
-                    data["location"] === undefined &&
+                    data[locationName] === undefined &&
                     ctx.location !== undefined) {
-                    data["location"] = ctx.location;
+                    data[locationName] = ctx.location;
                 }
-                const tagsShape = shape.byJsName["tags"];
-                if (tagsShape !== undefined &&
+                const tagsProperty = properties.find(([jsName, property]) => property.armPath.length <= 1 && (property.armPath[0] ?? jsName) === "tags");
+                const tagsName = tagsProperty?.[0];
+                const tagsShape = tagsProperty?.[1];
+                if (tagsName !== undefined &&
+                    tagsShape !== undefined &&
                     tagsShape.readOnly !== true &&
-                    data["tags"] === undefined &&
+                    data[tagsName] === undefined &&
                     ctx.tags !== undefined &&
                     Object.keys(ctx.tags).length > 0) {
-                    data["tags"] = { ...ctx.tags };
+                    data[tagsName] = { ...ctx.tags };
                 }
             }
         }
@@ -215,6 +252,9 @@ export class ResourceDeclaration extends ProvisioningComponent {
         }, path);
     }
     setProperty(key, value) {
+        if (key === "name") {
+            assertValidResourceName(value, this.type, this.namingRules);
+        }
         this.state[key] = normalizeAssignedValue(value, this);
     }
 }
@@ -315,26 +355,22 @@ export class Resource extends ResourceDeclaration {
      * Per-resource-type naming constraints, consumed by the active
      * {@link NamingPolicy} when a resource is created without an explicit
      * `name`. Generated CDK subclasses override this with a concrete value;
-     * the base default of `undefined` yields `MOST_RESTRICTIVE` behavior.
+     * the base default of `undefined` uses the default naming convention.
      *
      * This is type metadata, not user input, so it is kept off the public
      * props surface and read reflectively in the constructor via
      * `this.constructor` rather than being threaded through `ResourceProps`.
      */
     static namingRules;
+    /** Validates construction inputs before a scalar or looped declaration is registered. */
+    static validate(_context, _props, _options, _namingRules) {
+        // Resource subclasses can impose additional construction constraints.
+    }
     _selfProxy;
     constructor(context, props, options) {
-        super(context, props, options, 
-        // Naming rules live as a `protected static namingRules` field on
-        // each concrete resource subclass, not on the public props bag.
-        // Read reflectively off `new.target` (the most-derived class being
-        // instantiated) — `this.constructor` would work too but TS forbids
-        // touching `this` before `super()`. Static inheritance falls back
-        // to `Resource`'s `undefined` default when a subclass omits the
-        // field (e.g. singleton children). `resolveResourceName` (called
-        // inside `ResourceDeclaration`) treats `undefined` as
-        // `MOST_RESTRICTIVE`.
-        new.target.namingRules);
+        const namingRules = new.target.namingRules;
+        new.target.validate(context, props, options, namingRules);
+        super(context, props, options, namingRules);
         const proxy = createResourceProxy(this);
         this._selfProxy = proxy;
         // Tricky part for the proxy implementation:
@@ -525,7 +561,13 @@ export class LoopedResource extends ResourceDeclaration {
         // that threads `type` / `apiVersion` in from `userProps`. So there's no
         // existence branch here.
         const props = wrappedCtor.buildResourceProps.call(wrappedCtor, userProps);
-        super(context, props, options, wrappedCtor.namingRules);
+        if (props.name === undefined) {
+            throw new Error(`Looped resource '${props.type}' requires an explicit per-iteration name.`);
+        }
+        const namingRules = wrappedCtor
+            .namingRules;
+        wrappedCtor.validate.call(wrappedCtor, context, props, options, namingRules);
+        super(context, props, options, namingRules);
         this.#wrappedCtor = wrappedCtor;
         // Snapshot the loop metadata at declaration time. `indexVariable` is
         // recorded only if the index was requested by now — either the caller