@azure/provisioning-core 1.0.0-beta.1

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

@@ -0,0 +1,517 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { EXPRESSION_BRAND, isExpression, unwrapExpression, } from "../../expression/expressions.js";
+import { accessExpressionNode, arrayAccessExpressionNode, identifierExpressionNode, isExpressionNode, } from "../../expression/ast-nodes.js";
+import { navigateShape } from "../../shape/shape.js";
+import { getShape } from "../../shape/shape-registry.js";
+export const RAW_RESOURCE_HANDLE = Symbol("raw-resource-handle");
+export const RESOURCE_BRAND = Symbol.for("@azure/provisioning-core.Resource");
+/**
+ * Brand present on every `LoopedResource` instance. Lives here (rather than
+ * on the `LoopedResource` class) so tree-walking utilities can brand-check
+ * for looped declarations without a runtime import of `resource.ts` — which
+ * would create an eval-time import cycle (`resource.ts` extends `ProvisioningComponent`).
+ * Use {@link isLoopedResource} in normal code.
+ */
+export const LOOPED_RESOURCE_BRAND = Symbol.for("@azure/provisioning-core.LoopedResource");
+/**
+ * Brand present on every `ResourceDeclaration` instance (both scalar
+ * `Resource` and looped `LoopedResource`). Use
+ * {@link isResourceDeclaration} instead of a direct
+ * brand check.
+ */
+export const RESOURCE_DECLARATION_BRAND = Symbol.for("@azure/provisioning-core.ResourceDeclaration");
+/**
+ * Present on indexed resource proxies (see {@link createIndexedResourceProxy}).
+ * Reading it off any resource-like value returns the stored index expression
+ * for indexed proxies, and `undefined` for plain outer proxies. The base
+ * `Resource` constructor probes for it on the `context` argument to detect
+ * `parents.at(i)` / `parents.current()` being passed as a child parent
+ * context; other consumers may probe it for their own purposes (the proxy
+ * itself doesn't imply any parent-child relationship — the index is simply
+ * what identifies which element of a looped declaration this proxy refers
+ * to).
+ */
+export const PROXY_INDEX_REF = Symbol.for("@azure/provisioning-core.PROXY_INDEX_REF");
+/**
+ * Present on indexed resource proxies. Reading it returns the underlying
+ * outer-proxy resource that the indexed proxy wraps. Used by the base
+ * `Resource` constructor to normalize `this.parent` back to the raw parent
+ * (so tree walks and symbol-map lookups continue to work) while
+ * `PROXY_INDEX_REF` carries the "which index" information onto `state`.
+ */
+export const INDEXED_PROXY_TARGET = Symbol.for("@azure/provisioning-core.INDEXED_PROXY_TARGET");
+/**
+ * State-object key under which the base `Resource` constructor records the
+ * index expression when the `context` argument is an indexed proxy (i.e.,
+ * `parent.at(i)` / `parent.current()`). The serializer reads this key
+ * from the child's raw state to emit `parent: parentSym[<index>]` instead
+ * of the bare `parent: parentSym` form. Kept as a shared const so writer
+ * (`resource.ts`) and reader (`serialize.ts`) never drift.
+ *
+ * Lives on the **child**, not the parent: siblings under the same parent
+ * can be created via different indexed proxies (e.g. `new Child(p.at(0), …)`
+ * and `new Child(p.at(1), …)` both resolve `.parent` to the same raw parent,
+ * so the index that distinguishes them must be recorded per-child).
+ */
+export const STATE_PARENT_INDEX = "parentIndex";
+function stepsToPath(steps) {
+    return steps.map((s) => s.segment);
+}
+const PROPERTY_PROXY_STATE = Symbol("property-proxy-state");
+function isPropertyProxy(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        Reflect.get(value, PROPERTY_PROXY_STATE) !== undefined);
+}
+function getPropertyProxyState(value) {
+    return value[PROPERTY_PROXY_STATE];
+}
+export function deref(value) {
+    if (isPropertyProxy(value)) {
+        const state = getPropertyProxyState(value);
+        return getValueAtPath(state.root, stepsToPath(state.steps));
+    }
+    if (isResourceHandle(value)) {
+        return unwrapResourceHandle(value);
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// Path helpers
+// ---------------------------------------------------------------------------
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function getValueAtPath(root, path) {
+    let current = root;
+    for (const segment of path) {
+        if (typeof current !== "object" || current === null) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, String(segment))) {
+            return undefined;
+        }
+        current = current[String(segment)];
+    }
+    return current;
+}
+function setValueAtPath(root, path, value) {
+    let current = root;
+    for (let index = 0; index < path.length - 1; index += 1) {
+        const segment = String(path[index]);
+        const nextSegment = path[index + 1];
+        const existing = Object.prototype.hasOwnProperty.call(current, segment)
+            ? current[segment]
+            : undefined;
+        if (typeof existing === "object" && existing !== null) {
+            current = existing;
+            continue;
+        }
+        const container = (typeof nextSegment === "number" ? [] : Object.create(null));
+        Object.defineProperty(current, segment, {
+            value: container,
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
+        current = container;
+    }
+    Object.defineProperty(current, String(path[path.length - 1]), {
+        value,
+        enumerable: true,
+        configurable: true,
+        writable: true,
+    });
+}
+// ---------------------------------------------------------------------------
+// Expression construction
+// ---------------------------------------------------------------------------
+function createMemberAccessPathExpression(resource, steps, index) {
+    let current = identifierExpressionNode(resource);
+    if (index !== undefined) {
+        current = arrayAccessExpressionNode(current, index);
+    }
+    for (const { segment, armPath } of steps) {
+        current = accessExpressionNode(current, segment, { armPath });
+    }
+    return current;
+}
+// ---------------------------------------------------------------------------
+// Value normalization
+// ---------------------------------------------------------------------------
+export function normalizeAssignedValue(value, currentResource) {
+    if (isPropertyProxy(value)) {
+        const state = getPropertyProxyState(value);
+        if (currentResource && state.resource === currentResource) {
+            // Same-resource proxy → inline raw value (avoids self-references)
+            return getValueAtPath(state.root, stepsToPath(state.steps));
+        }
+        return createMemberAccessPathExpression(state.resource, state.steps, state.index);
+    }
+    if (isResourceHandle(value)) {
+        return identifierExpressionNode(value);
+    }
+    if (isExpression(value)) {
+        return unwrapExpression(value);
+    }
+    if (isExpressionNode(value)) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeAssignedValue(item, currentResource));
+    }
+    if (isPlainObject(value)) {
+        return normalizeObjectValue(value, currentResource);
+    }
+    return value;
+}
+function normalizeObjectValue(obj, currentResource) {
+    const entries = Object.entries(obj);
+    const result = Object.create(null);
+    for (const [key, value] of entries) {
+        if (isPropertyProxy(value)) {
+            const state = getPropertyProxyState(value);
+            if (currentResource && state.resource === currentResource) {
+                // Same-resource → inline raw value (avoids self-references)
+                result[key] = getValueAtPath(state.root, stepsToPath(state.steps));
+                continue;
+            }
+        }
+        result[key] = normalizeAssignedValue(value, currentResource);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Property proxy
+// ---------------------------------------------------------------------------
+function toPropertySegment(property, nav, currentValue) {
+    const isIndexedContainer = nav?.kind === "array" || nav?.kind === "tuple" || Array.isArray(currentValue);
+    return isIndexedContainer && /^\d+$/u.test(property) ? Number(property) : property;
+}
+function getPropertyProxyTarget(state) {
+    const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));
+    if (typeof currentValue === "object" && currentValue !== null) {
+        return currentValue;
+    }
+    return {};
+}
+function createPropertyProxy(state) {
+    // Always use a fresh empty target — avoids Proxy invariant violations
+    // when the stored value has non-configurable properties (e.g. EXPRESSION_BRAND).
+    const target = {};
+    return new Proxy(target, {
+        has(proxyTarget, property) {
+            if (property === PROPERTY_PROXY_STATE || property === EXPRESSION_BRAND) {
+                return true;
+            }
+            const backing = getPropertyProxyTarget(state);
+            if (Reflect.has(backing, property))
+                return true;
+            return Reflect.has(proxyTarget, property);
+        },
+        ownKeys() {
+            const backing = getPropertyProxyTarget(state);
+            return Reflect.ownKeys(backing).filter((k) => typeof k === "string");
+        },
+        getOwnPropertyDescriptor(_proxyTarget, property) {
+            const backing = getPropertyProxyTarget(state);
+            if (typeof property === "string" && Object.prototype.hasOwnProperty.call(backing, property)) {
+                return { enumerable: true, configurable: true, writable: true };
+            }
+            return undefined;
+        },
+        get(proxyTarget, property, receiver) {
+            if (property === PROPERTY_PROXY_STATE) {
+                return state;
+            }
+            if (property === EXPRESSION_BRAND) {
+                return createMemberAccessPathExpression(state.resource, state.steps, state.index);
+            }
+            if (property === Symbol.toPrimitive) {
+                return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(".")}]`;
+            }
+            if (typeof property !== "string") {
+                return Reflect.get(proxyTarget, property, receiver);
+            }
+            if (property === "toString") {
+                return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(".")}]`;
+            }
+            if (property === "valueOf") {
+                return () => createMemberAccessPathExpression(state.resource, state.steps, state.index);
+            }
+            if (property === "then") {
+                return undefined;
+            }
+            const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));
+            const segment = toPropertySegment(property, state.nav, currentValue);
+            // Pass the value at the current position so a discriminated nav
+            // can select its variant (see `resolveModelShape`).
+            const step = navigateShape(state.nav, segment, currentValue);
+            const nextArmPath = step.stamp?.armPath;
+            const nextNav = step.next;
+            return createPropertyProxy({
+                ...state,
+                steps: [...state.steps, { segment, armPath: nextArmPath }],
+                nav: nextNav,
+            });
+        },
+        set(_proxyTarget, property, value) {
+            if (typeof property !== "string") {
+                return false;
+            }
+            // A looped element (`parent.at(i)`) yields member proxies stamped with
+            // an index. Writing through one would mutate the shared for-loop body,
+            // which is not valid Bicep — `sym[i].prop = ...` cannot be expressed.
+            if (state.index !== undefined) {
+                throwLoopedElementWriteError();
+            }
+            setValueAtPath(state.root, [
+                ...stepsToPath(state.steps),
+                toPropertySegment(property, state.nav, getValueAtPath(state.root, stepsToPath(state.steps))),
+            ], normalizeAssignedValue(value, state.resource));
+            return true;
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// Resource member proxy
+// ---------------------------------------------------------------------------
+function isNonEnumerableOwnProperty(target, property) {
+    const descriptor = Reflect.getOwnPropertyDescriptor(target, property);
+    return descriptor?.enumerable === false;
+}
+function hasOwnOrPrototypeProperty(target, property) {
+    let current = target;
+    while (current !== null) {
+        if (Object.prototype.hasOwnProperty.call(current, property)) {
+            return true;
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return false;
+}
+export function createResourceMemberProxy(source, path) {
+    // Seed nav from the resource's shape (if any). Walk the existing
+    // path, transitioning nav at each step so every segment is stamped
+    // correctly. Pre-existing callers pass paths they built manually, so
+    // we treat unknown navigations as passthrough.
+    const rootShape = getResourceShape(source.resource);
+    let nav = rootShape;
+    const steps = [];
+    for (const segment of path) {
+        const step = navigateShape(nav, segment, getValueAtPath(source.root, stepsToPath(steps)));
+        steps.push({ segment, armPath: step.stamp?.armPath });
+        nav = step.next;
+    }
+    return createPropertyProxy({
+        ...source,
+        steps,
+        nav,
+    });
+}
+function getResourceShape(resource) {
+    // Look up by (armType, apiVersion), letting the registry resolve
+    // any discriminated variant from the instance's own state (typically
+    // the hardcoded `name` literal each variant class sets).
+    const state = resource[RAW_RESOURCE_HANDLE];
+    return getShape(resource.type, resource.apiVersion, state);
+}
+// ---------------------------------------------------------------------------
+// Resource-level proxy
+// ---------------------------------------------------------------------------
+export function createResourceProxy(resource) {
+    function getBackingResourceData(target) {
+        return Reflect.get(target, RAW_RESOURCE_HANDLE);
+    }
+    const proxy = new Proxy(resource, {
+        ownKeys(target) {
+            return Array.from(new Set([
+                ...Reflect.ownKeys(target),
+                ...Reflect.ownKeys(getBackingResourceData(target)).filter((key) => key !== RAW_RESOURCE_HANDLE),
+            ]));
+        },
+        getOwnPropertyDescriptor(target, property) {
+            const targetDescriptor = Reflect.getOwnPropertyDescriptor(target, property);
+            if (targetDescriptor !== undefined) {
+                return targetDescriptor;
+            }
+            const backing = getBackingResourceData(target);
+            if (Object.prototype.hasOwnProperty.call(backing, property)) {
+                return { enumerable: true, configurable: true, writable: true };
+            }
+            return undefined;
+        },
+        get(target, property, receiver) {
+            if (typeof property !== "string") {
+                return Reflect.get(target, property, receiver);
+            }
+            if (property === "then") {
+                return Reflect.get(target, property, receiver);
+            }
+            if (hasOwnOrPrototypeProperty(target, property) ||
+                isNonEnumerableOwnProperty(target, property)) {
+                return Reflect.get(target, property, receiver);
+            }
+            const rootState = unwrapResourceHandle(proxy);
+            const rootShape = getResourceShape(target);
+            const segment = toPropertySegment(property, rootShape, rootState);
+            const step = navigateShape(rootShape, segment, rootState);
+            const armPath = step.stamp?.armPath;
+            const nav = step.next;
+            return createPropertyProxy({
+                resource: proxy,
+                root: rootState,
+                steps: [{ segment, armPath }],
+                nav,
+            });
+        },
+        set(target, property, value, receiver) {
+            if (typeof property !== "string") {
+                return Reflect.set(target, property, value, receiver);
+            }
+            if (hasOwnOrPrototypeProperty(target, property) ||
+                isNonEnumerableOwnProperty(target, property)) {
+                return Reflect.set(target, property, value, receiver);
+            }
+            setValueAtPath(unwrapResourceHandle(proxy), [toPropertySegment(property, getResourceShape(target), unwrapResourceHandle(proxy))], normalizeAssignedValue(value, proxy));
+            return true;
+        },
+    });
+    return proxy;
+}
+// ---------------------------------------------------------------------------
+// Resource handle detection
+// ---------------------------------------------------------------------------
+function isResourceHandle(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[RESOURCE_BRAND] === true);
+}
+export function unwrapResourceHandle(resource) {
+    const maybeRaw = Reflect.get(resource, RAW_RESOURCE_HANDLE);
+    if (maybeRaw === undefined) {
+        return resource;
+    }
+    return maybeRaw;
+}
+function throwLoopedElementWriteError() {
+    throw new Error("Cannot assign to a property of a looped resource declaration. Individual loop iterations cannot be mutated. Set the property in the declaration passed to `fromLoop(loop, ...)`");
+}
+export function createIndexedResourceProxy(resource, index) {
+    const resourceIndexExpression = isExpression(index)
+        ? unwrapExpression(index)
+        : index;
+    const root = unwrapResourceHandle(resource);
+    // A looped declaration (`LoopedResource`) exposes the concrete subclass
+    // ctor it wraps via `wrappedCtor`; its prototype carries the subclass's
+    // ARM accessors (`.sku`, `.properties.*`, `.id`, `.name`). The `get` trap
+    // below walks this prototype to resolve those reads rooted at
+    // `sym[index]`. A scalar `Resource` has no `wrappedCtor` — it already
+    // carries those accessors on its own prototype, so `subclassProto` stays
+    // `undefined` and lookups resolve via the target's own chain.
+    const subclassProto = resource
+        .wrappedCtor?.prototype;
+    return new Proxy(resource, {
+        // Deliberately NO `getPrototypeOf` trap. Exposing the subclass
+        // prototype here would make `proxy instanceof Subclass` report `true`,
+        // invoking subclass getters/methods against the bare `LoopedResource`
+        // target (which lacks the subclass's own instance slots). Property
+        // reads and writes don't need it: the `get`/`set` traps below have
+        // their own `subclassProto` fallbacks that run accessors with
+        // `this = receiver` (the proxy) so `this.expr(...)` resolves against the
+        // indexed element.
+        get(target, property, receiver) {
+            // Reveal-only symbols consulted by the base `Resource` constructor
+            // and by serialization; both are marker keys with no runtime prototype
+            // representation on plain resources.
+            if (property === PROXY_INDEX_REF)
+                return resourceIndexExpression;
+            if (property === INDEXED_PROXY_TARGET)
+                return target;
+            // Intercept the single funnel for ARM reads. `this.expr(...path)` is
+            // the getter body used by every generated ARM property (`.name`,
+            // `.id`, `.properties.*`, etc.). Route it through
+            // `createResourceMemberProxy` with our `resourceIndexExpression` so
+            // the whole emitted expression roots at `sym[index]` instead of `sym`.
+            if (property === "expr") {
+                return function boundIndexedExpr(...path) {
+                    return createResourceMemberProxy({
+                        resource: target,
+                        root,
+                        index: resourceIndexExpression,
+                    }, path);
+                };
+            }
+            // Block ARM property writes on a looped element. Every generated ARM
+            // setter (`set sku`, `set properties`, `set name`, …) funnels through
+            // `this.setProperty(...)`, so intercepting that single method turns
+            // `parent.at(i).sku = ...` into a clear error.
+            if (property === "setProperty") {
+                return throwLoopedElementWriteError;
+            }
+            // First try the target's own chain. Two subtleties:
+            //
+            // 1. Getters (`.type`, `.apiVersion`, `.children`, `.parent`, …) must
+            //    run with `this = target` so they see the raw resource's own
+            //    properties — including class private fields (`#…`). Passing the
+            //    proxy as `receiver` would cause private-field access inside a
+            //    getter to fail because the proxy has no such slot.
+            // 2. Subclass methods need `this = target` for the same reason — private
+            //    fields again — so
+            //    we return a bound wrapper. This means `ctx.method === ctx.method`
+            //    yields `false` between reads; acceptable trade-off given no
+            //    caller relies on function identity on an indexed proxy.
+            if (property in target) {
+                const value = Reflect.get(target, property, target);
+                return typeof value === "function" ? value.bind(target) : value;
+            }
+            // Fall through to `subclassProto` for subclass-specific getters
+            // (e.g. `.id`, `.name`, `.sku`) when wrapping a `LoopedResource`.
+            // Getters must run with `this = receiver` (the proxy) so their
+            // `this.expr(...)` calls hit our intercept above, yielding an
+            // expression rooted at `sym[index]`. Methods bind to `target` to
+            // stay consistent with the passthrough branch above.
+            if (subclassProto !== undefined) {
+                let proto = subclassProto;
+                while (proto !== null && proto !== Object.prototype) {
+                    const descriptor = Object.getOwnPropertyDescriptor(proto, property);
+                    if (descriptor !== undefined) {
+                        if (descriptor.get !== undefined) {
+                            return descriptor.get.call(receiver);
+                        }
+                        const value = descriptor.value;
+                        return typeof value === "function" ? value.bind(target) : value;
+                    }
+                    proto = Object.getPrototypeOf(proto);
+                }
+            }
+            return undefined;
+        },
+        // Route writes to an ARM property setter with `this = receiver` (the
+        // proxy), allowing its `setProperty` call to hit the rejection above.
+        // Falls back to a plain write on the raw target.
+        set(target, property, value, receiver) {
+            if (subclassProto !== undefined) {
+                let proto = subclassProto;
+                while (proto !== null && proto !== Object.prototype) {
+                    const descriptor = Object.getOwnPropertyDescriptor(proto, property);
+                    if (descriptor !== undefined) {
+                        if (descriptor.set !== undefined) {
+                            descriptor.set.call(receiver, value);
+                            return true;
+                        }
+                        break;
+                    }
+                    proto = Object.getPrototypeOf(proto);
+                }
+            }
+            return Reflect.set(target, property, value, target);
+        },
+    });
+}
+//# sourceMappingURL=resource-proxy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-proxy.js","sourceRoot":"","sources":["../../../../src/constructs/resource/resource-proxy.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAElC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GAGjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,GAGjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAsC,MAAM,sBAAsB,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,GAAG,CAClD,8CAA8C,CAC/C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;AAEhG;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAsB,CAAC;AAoDzD,SAAS,WAAW,CAAC,KAA8B;IACjD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAE5D,SAAS,eAAe,CACtB,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,CAAC,GAAG,CAAC,KAAe,EAAE,oBAAoB,CAAC,KAAK,SAAS,CACjE,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAE9B;IACC,OAAO,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACrC,CAAC;AAQD,MAAM,UAAU,KAAK,CAAI,KAAQ;IAC/B,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAa,CAAC;IAC1E,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,oBAAoB,CAAC,KAAK,CAAa,CAAC;IACjD,CAAC;IAED,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,SAAS,cAAc,CAAC,IAA6B,EAAE,IAAgC;IACrF,IAAI,OAAO,GAAY,IAAI,CAAC;IAE5B,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CACrB,IAA6B,EAC7B,IAAgC,EAChC,KAAc;IAEd,IAAI,OAAO,GAA4B,IAAI,CAAC;IAE5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;YACrE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YAClB,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtD,OAAO,GAAG,QAAmC,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAG5E,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE;YACtC,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,OAAO,GAAG,SAAS,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE;QAC5D,KAAK;QACL,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,SAAS,gCAAgC,CACvC,QAAkB,EAClB,KAA8B,EAC9B,KAAwB;IAExB,IAAI,OAAO,GAAmB,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,GAAG,yBAAyB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;QACzC,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,eAA0B;IAC/E,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,eAAe,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YAC1D,kEAAkE;YAClE,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,gCAAgC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC,KAAgC,EAAE,eAAe,CAAC,CAAC;IACjF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAC3B,GAA4B,EAC5B,eAA0B;IAE1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE5D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,eAAe,IAAI,KAAK,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;gBAC1D,4DAA4D;gBAC5D,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnE,SAAS;YACX,CAAC;QACH,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,SAAS,iBAAiB,CACxB,QAAgB,EAChB,GAAa,EACb,YAAqB;IAErB,MAAM,kBAAkB,GACtB,GAAG,EAAE,IAAI,KAAK,OAAO,IAAI,GAAG,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,OAAO,kBAAkB,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrF,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAyB;IACvD,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAE1E,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAyB;IACpD,sEAAsE;IACtE,iFAAiF;IACjF,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,WAAW,EAAE,QAAQ;YACvB,IAAI,QAAQ,KAAK,oBAAoB,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;gBACvE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChD,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO;YACL,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACpF,CAAC;QAED,wBAAwB,CAAC,YAAY,EAAE,QAAQ;YAC7C,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC5F,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAClE,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ;YACjC,IAAI,QAAQ,KAAK,oBAAoB,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;gBAClC,OAAO,gCAAgC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACpF,CAAC;YAED,IAAI,QAAQ,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC;gBACpC,OAAO,GAAG,EAAE,CAAC,mBAAmB,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACpF,CAAC;YAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACtD,CAAC;YAED,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,GAAG,EAAE,CAAC,mBAAmB,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACpF,CAAC;YAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,GAAG,EAAE,CAAC,gCAAgC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1F,CAAC;YAED,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YACrE,gEAAgE;YAChE,oDAAoD;YACpD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;YAE1B,OAAO,mBAAmB,CAAC;gBACzB,GAAG,KAAK;gBACR,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;gBAC1D,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;QACL,CAAC;QAED,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK;YAC/B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,uEAAuE;YACvE,uEAAuE;YACvE,sEAAsE;YACtE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC9B,4BAA4B,EAAE,CAAC;YACjC,CAAC;YAED,cAAc,CACZ,KAAK,CAAC,IAAI,EACV;gBACE,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC3B,iBAAiB,CACf,QAAQ,EACR,KAAK,CAAC,GAAG,EACT,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CACrD;aACF,EACD,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAC9C,CAAC;YAEF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,SAAS,0BAA0B,CAAC,MAAc,EAAE,QAAgB;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtE,OAAO,UAAU,EAAE,UAAU,KAAK,KAAK,CAAC;AAC1C,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAc,EAAE,QAAgB;IACjE,IAAI,OAAO,GAAkB,MAAM,CAAC;IAEpC,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA2B,EAC3B,IAAgC;IAEhC,iEAAiE;IACjE,mEAAmE;IACnE,qEAAqE;IACrE,+CAA+C;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,GAAG,GAAa,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1F,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,mBAAmB,CAAC;QACzB,GAAG,MAAM;QACT,KAAK;QACL,GAAG;KACJ,CAAgC,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,iEAAiE;IACjE,qEAAqE;IACrE,yDAAyD;IACzD,MAAM,KAAK,GAAI,QAA0E,CACvF,mBAAmB,CACpB,CAAC;IACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CAGjC,QAAmB;IACnB,SAAS,sBAAsB,CAAC,MAAiB;QAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAA4B,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE;QAChC,OAAO,CAAC,MAAM;YACZ,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CAAC;gBACN,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACvD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,mBAAmB,CACrC;aACF,CAAC,CACH,CAAC;QACJ,CAAC;QAED,wBAAwB,CAAC,MAAM,EAAE,QAAQ;YACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC5E,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,gBAAgB,CAAC;YAC1B,CAAC;YAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC5D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAClE,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC5B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;YAED,IACE,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAC3C,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5C,CAAC;gBACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAA4B,CAAC;YACzE,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;YAEtB,OAAO,mBAAmB,CAAC;gBACzB,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;gBAC7B,GAAG;aACJ,CAAC,CAAC;QACL,CAAC;QAED,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;YACnC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxD,CAAC;YAED,IACE,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAC3C,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5C,CAAC;gBACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YACxD,CAAC;YAED,cAAc,CACZ,oBAAoB,CAAC,KAAK,CAA4B,EACtD,CAAC,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,EACpF,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CACrC,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAAiC,CAAC,cAAc,CAAC,KAAK,IAAI,CAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAgC,QAAW;IAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAkB,EAAE,mBAAmB,CAAC,CAAC;IAEtE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,QAAa,CAAC;AACvB,CAAC;AAqDD,SAAS,4BAA4B;IACnC,MAAM,IAAI,KAAK,CACb,iLAAiL,CAClL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAW,EACX,KAAgC;IAEhC,MAAM,uBAAuB,GAAqB,YAAY,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,gBAAgB,CAAC,KAA2B,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC;IACV,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,CAAuC,CAAC;IAElF,wEAAwE;IACxE,wEAAwE;IACxE,0EAA0E;IAC1E,8DAA8D;IAC9D,sEAAsE;IACtE,yEAAyE;IACzE,8DAA8D;IAC9D,MAAM,aAAa,GAAI,QAAsE;SAC1F,WAAW,EAAE,SAAS,CAAC;IAE1B,OAAO,IAAI,KAAK,CAAC,QAAkB,EAAE;QACnC,+DAA+D;QAC/D,uEAAuE;QACvE,sEAAsE;QACtE,mEAAmE;QACnE,mEAAmE;QACnE,8DAA8D;QAC9D,yEAAyE;QACzE,mBAAmB;QACnB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ;YAC5B,mEAAmE;YACnE,uEAAuE;YACvE,qCAAqC;YACrC,IAAI,QAAQ,KAAK,eAAe;gBAAE,OAAO,uBAAuB,CAAC;YACjE,IAAI,QAAQ,KAAK,oBAAoB;gBAAE,OAAO,MAAM,CAAC;YAErD,qEAAqE;YACrE,iEAAiE;YACjE,kDAAkD;YAClD,oEAAoE;YACpE,uEAAuE;YACvE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,SAAS,gBAAgB,CAAC,GAAG,IAAgC;oBAClE,OAAO,yBAAyB,CAC9B;wBACE,QAAQ,EAAE,MAAkB;wBAC5B,IAAI;wBACJ,KAAK,EAAE,uBAAuB;qBAC/B,EACD,IAAI,CACL,CAAC;gBACJ,CAAC,CAAC;YACJ,CAAC;YAED,qEAAqE;YACrE,sEAAsE;YACtE,oEAAoE;YACpE,+CAA+C;YAC/C,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC/B,OAAO,4BAA4B,CAAC;YACtC,CAAC;YAED,oDAAoD;YACpD,EAAE;YACF,sEAAsE;YACtE,iEAAiE;YACjE,qEAAqE;YACrE,mEAAmE;YACnE,wDAAwD;YACxD,yEAAyE;YACzE,uBAAuB;YACvB,uEAAuE;YACvE,iEAAiE;YACjE,6DAA6D;YAC7D,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACpD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAClE,CAAC;YAED,gEAAgE;YAChE,kEAAkE;YAClE,+DAA+D;YAC/D,8DAA8D;YAC9D,iEAAiE;YACjE,qDAAqD;YACrD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,KAAK,GAAkB,aAAa,CAAC;gBACzC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;oBACpD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;oBACpE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC7B,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;4BACjC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBACvC,CAAC;wBACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;wBAC/B,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBAClE,CAAC;oBACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,qEAAqE;QACrE,sEAAsE;QACtE,iDAAiD;QACjD,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;YACnC,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,KAAK,GAAkB,aAAa,CAAC;gBACzC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;oBACpD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;oBACpE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC7B,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;4BACjC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;4BACrC,OAAO,IAAI,CAAC;wBACd,CAAC;wBACD,MAAM;oBACR,CAAC;oBACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;KACF,CAAsB,CAAC;AAC1B,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT License.\n\nimport {\n  EXPRESSION_BRAND,\n  isExpression,\n  unwrapExpression,\n  type Expression,\n  type ExpressionOrValue,\n} from \"../../expression/expressions.js\";\nimport {\n  accessExpressionNode,\n  arrayAccessExpressionNode,\n  identifierExpressionNode,\n  isExpressionNode,\n  type ArrayAccessIndex,\n  type ExpressionNode,\n} from \"../../expression/ast-nodes.js\";\nimport type { PropertySegment } from \"../../types.js\";\nimport type { LoopedResource, Resource, ResourceDeclaration } from \"./resource.js\";\nimport { navigateShape, type FlatModelShape, type NavShape } from \"../../shape/shape.js\";\nimport { getShape } from \"../../shape/shape-registry.js\";\n\nexport const RAW_RESOURCE_HANDLE = Symbol(\"raw-resource-handle\");\nexport const RESOURCE_BRAND = Symbol.for(\"@azure/provisioning-core.Resource\");\n\n/**\n * Brand present on every `LoopedResource` instance. Lives here (rather than\n * on the `LoopedResource` class) so tree-walking utilities can brand-check\n * for looped declarations without a runtime import of `resource.ts` — which\n * would create an eval-time import cycle (`resource.ts` extends `ProvisioningComponent`).\n * Use {@link isLoopedResource} in normal code.\n */\nexport const LOOPED_RESOURCE_BRAND = Symbol.for(\"@azure/provisioning-core.LoopedResource\");\n\n/**\n * Brand present on every `ResourceDeclaration` instance (both scalar\n * `Resource` and looped `LoopedResource`). Use\n * {@link isResourceDeclaration} instead of a direct\n * brand check.\n */\nexport const RESOURCE_DECLARATION_BRAND = Symbol.for(\n  \"@azure/provisioning-core.ResourceDeclaration\",\n);\n\n/**\n * Present on indexed resource proxies (see {@link createIndexedResourceProxy}).\n * Reading it off any resource-like value returns the stored index expression\n * for indexed proxies, and `undefined` for plain outer proxies. The base\n * `Resource` constructor probes for it on the `context` argument to detect\n * `parents.at(i)` / `parents.current()` being passed as a child parent\n * context; other consumers may probe it for their own purposes (the proxy\n * itself doesn't imply any parent-child relationship — the index is simply\n * what identifies which element of a looped declaration this proxy refers\n * to).\n */\nexport const PROXY_INDEX_REF = Symbol.for(\"@azure/provisioning-core.PROXY_INDEX_REF\");\n\n/**\n * Present on indexed resource proxies. Reading it returns the underlying\n * outer-proxy resource that the indexed proxy wraps. Used by the base\n * `Resource` constructor to normalize `this.parent` back to the raw parent\n * (so tree walks and symbol-map lookups continue to work) while\n * `PROXY_INDEX_REF` carries the \"which index\" information onto `state`.\n */\nexport const INDEXED_PROXY_TARGET = Symbol.for(\"@azure/provisioning-core.INDEXED_PROXY_TARGET\");\n\n/**\n * State-object key under which the base `Resource` constructor records the\n * index expression when the `context` argument is an indexed proxy (i.e.,\n * `parent.at(i)` / `parent.current()`). The serializer reads this key\n * from the child's raw state to emit `parent: parentSym[<index>]` instead\n * of the bare `parent: parentSym` form. Kept as a shared const so writer\n * (`resource.ts`) and reader (`serialize.ts`) never drift.\n *\n * Lives on the **child**, not the parent: siblings under the same parent\n * can be created via different indexed proxies (e.g. `new Child(p.at(0), …)`\n * and `new Child(p.at(1), …)` both resolve `.parent` to the same raw parent,\n * so the index that distinguishes them must be recorded per-child).\n */\nexport const STATE_PARENT_INDEX = \"parentIndex\" as const;\n\n// ---------------------------------------------------------------------------\n// Property proxy internal types\n// ---------------------------------------------------------------------------\n\n/**\n * A single step in a property proxy's walk from the root resource. Each step\n * carries the path segment (member name or array index) and the ARM\n * `PropertyShape` stamp's `armPath` for that step (if known). The parallel `path`/`stamps`\n * arrays this replaces could drift in length; a single array of steps makes\n * the invariant structural.\n */\ninterface PropertyStep {\n  readonly segment: PropertySegment;\n  readonly armPath?: readonly string[] | undefined;\n}\n\n/**\n * The identity a member-proxy needs to lower into a Bicep expression and to\n * back reads/writes. Bundles the three roles that were previously passed\n * positionally to {@link createResourceMemberProxy}:\n *\n * - `resource` — the tree-registered declaration that supplies BOTH the\n *   symbol root (`identifierExpressionNode(resource)`) and the ARM shape\n *   source (`getResourceShape`). For a scalar resource this is the outer\n *   resource proxy; for an indexed looped element it is the raw\n *   `LoopedResource` declaration (the tree citizen), NOT the ephemeral\n *   `.at(i)` handle — that handle isn't in the component tree, so it can't\n *   resolve to a Bicep symbol.\n * - `root` — the raw backing object that stores assigned values, used by\n *   `deref(...)` and nested writes.\n * - `index` — optional array index. When set, the emitted expression roots\n *   at `resource[index]` instead of `resource`, so `many.at(i).prop.blob`\n *   serializes as `sym[i].prop.blob`. Populated for `.at(i)` / `.current()`\n *   handles by {@link createIndexedResourceProxy}.\n */\nexport interface ResourceProxySource {\n  readonly resource: Resource;\n  readonly root: Record<string, unknown>;\n  readonly index?: ArrayAccessIndex;\n}\n\ninterface PropertyProxyState extends ResourceProxySource {\n  // The member/index path from the root resource to the current proxied value,\n  // each entry paired with its wire `armPath` stamp (if known).\n  readonly steps: readonly PropertyStep[];\n  // Current ARM shape navigation state. `undefined` at any level means\n  // \"untyped from here down\"; subsequent accesses are passthrough.\n  readonly nav?: NavShape;\n}\n\nfunction stepsToPath(steps: readonly PropertyStep[]): readonly PropertySegment[] {\n  return steps.map((s) => s.segment);\n}\n\nconst PROPERTY_PROXY_STATE = Symbol(\"property-proxy-state\");\n\nfunction isPropertyProxy(\n  value: unknown,\n): value is { readonly [PROPERTY_PROXY_STATE]: PropertyProxyState } {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    Reflect.get(value as object, PROPERTY_PROXY_STATE) !== undefined\n  );\n}\n\nfunction getPropertyProxyState(value: {\n  readonly [PROPERTY_PROXY_STATE]: PropertyProxyState;\n}): PropertyProxyState {\n  return value[PROPERTY_PROXY_STATE];\n}\n\n// ---------------------------------------------------------------------------\n// Deref\n// ---------------------------------------------------------------------------\n\nexport type Deref<T> = T extends Expression<infer U> ? U : T;\n\nexport function deref<T>(value: T): Deref<T> {\n  if (isPropertyProxy(value)) {\n    const state = getPropertyProxyState(value);\n    return getValueAtPath(state.root, stepsToPath(state.steps)) as Deref<T>;\n  }\n\n  if (isResourceHandle(value)) {\n    return unwrapResourceHandle(value) as Deref<T>;\n  }\n\n  return value as Deref<T>;\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers\n// ---------------------------------------------------------------------------\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction getValueAtPath(root: Record<string, unknown>, path: readonly PropertySegment[]): unknown {\n  let current: unknown = root;\n\n  for (const segment of path) {\n    if (typeof current !== \"object\" || current === null) {\n      return undefined;\n    }\n\n    if (!Object.prototype.hasOwnProperty.call(current, String(segment))) {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[String(segment)];\n  }\n\n  return current;\n}\n\nfunction setValueAtPath(\n  root: Record<string, unknown>,\n  path: readonly PropertySegment[],\n  value: unknown,\n): void {\n  let current: Record<string, unknown> = root;\n\n  for (let index = 0; index < path.length - 1; index += 1) {\n    const segment = String(path[index]);\n    const nextSegment = path[index + 1];\n    const existing = Object.prototype.hasOwnProperty.call(current, segment)\n      ? current[segment]\n      : undefined;\n\n    if (typeof existing === \"object\" && existing !== null) {\n      current = existing as Record<string, unknown>;\n      continue;\n    }\n\n    const container = (typeof nextSegment === \"number\" ? [] : Object.create(null)) as Record<\n      string,\n      unknown\n    >;\n    Object.defineProperty(current, segment, {\n      value: container,\n      enumerable: true,\n      configurable: true,\n      writable: true,\n    });\n    current = container;\n  }\n\n  Object.defineProperty(current, String(path[path.length - 1]), {\n    value,\n    enumerable: true,\n    configurable: true,\n    writable: true,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Expression construction\n// ---------------------------------------------------------------------------\n\nfunction createMemberAccessPathExpression(\n  resource: Resource,\n  steps: readonly PropertyStep[],\n  index?: ArrayAccessIndex,\n): ExpressionNode {\n  let current: ExpressionNode = identifierExpressionNode(resource);\n  if (index !== undefined) {\n    current = arrayAccessExpressionNode(current, index);\n  }\n  for (const { segment, armPath } of steps) {\n    current = accessExpressionNode(current, segment, { armPath });\n  }\n  return current;\n}\n\n// ---------------------------------------------------------------------------\n// Value normalization\n// ---------------------------------------------------------------------------\n\nexport function normalizeAssignedValue(value: unknown, currentResource?: Resource): unknown {\n  if (isPropertyProxy(value)) {\n    const state = getPropertyProxyState(value);\n    if (currentResource && state.resource === currentResource) {\n      // Same-resource proxy → inline raw value (avoids self-references)\n      return getValueAtPath(state.root, stepsToPath(state.steps));\n    }\n    return createMemberAccessPathExpression(state.resource, state.steps, state.index);\n  }\n\n  if (isResourceHandle(value)) {\n    return identifierExpressionNode(value);\n  }\n\n  if (isExpression(value)) {\n    return unwrapExpression(value);\n  }\n\n  if (isExpressionNode(value)) {\n    return value;\n  }\n\n  if (Array.isArray(value)) {\n    return value.map((item) => normalizeAssignedValue(item, currentResource));\n  }\n\n  if (isPlainObject(value)) {\n    return normalizeObjectValue(value as Record<string, unknown>, currentResource);\n  }\n\n  return value;\n}\n\nfunction normalizeObjectValue(\n  obj: Record<string, unknown>,\n  currentResource?: Resource,\n): Record<string, unknown> {\n  const entries = Object.entries(obj);\n  const result: Record<string, unknown> = Object.create(null);\n\n  for (const [key, value] of entries) {\n    if (isPropertyProxy(value)) {\n      const state = getPropertyProxyState(value);\n      if (currentResource && state.resource === currentResource) {\n        // Same-resource → inline raw value (avoids self-references)\n        result[key] = getValueAtPath(state.root, stepsToPath(state.steps));\n        continue;\n      }\n    }\n\n    result[key] = normalizeAssignedValue(value, currentResource);\n  }\n\n  return result;\n}\n\n// ---------------------------------------------------------------------------\n// Property proxy\n// ---------------------------------------------------------------------------\n\nfunction toPropertySegment(\n  property: string,\n  nav: NavShape,\n  currentValue: unknown,\n): PropertySegment {\n  const isIndexedContainer =\n    nav?.kind === \"array\" || nav?.kind === \"tuple\" || Array.isArray(currentValue);\n  return isIndexedContainer && /^\\d+$/u.test(property) ? Number(property) : property;\n}\n\nfunction getPropertyProxyTarget(state: PropertyProxyState): object {\n  const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));\n\n  if (typeof currentValue === \"object\" && currentValue !== null) {\n    return currentValue;\n  }\n\n  return {};\n}\n\nfunction createPropertyProxy(state: PropertyProxyState): unknown {\n  // Always use a fresh empty target — avoids Proxy invariant violations\n  // when the stored value has non-configurable properties (e.g. EXPRESSION_BRAND).\n  const target = {};\n\n  return new Proxy(target, {\n    has(proxyTarget, property) {\n      if (property === PROPERTY_PROXY_STATE || property === EXPRESSION_BRAND) {\n        return true;\n      }\n\n      const backing = getPropertyProxyTarget(state);\n      if (Reflect.has(backing, property)) return true;\n      return Reflect.has(proxyTarget, property);\n    },\n\n    ownKeys() {\n      const backing = getPropertyProxyTarget(state);\n      return Reflect.ownKeys(backing).filter((k): k is string => typeof k === \"string\");\n    },\n\n    getOwnPropertyDescriptor(_proxyTarget, property) {\n      const backing = getPropertyProxyTarget(state);\n      if (typeof property === \"string\" && Object.prototype.hasOwnProperty.call(backing, property)) {\n        return { enumerable: true, configurable: true, writable: true };\n      }\n      return undefined;\n    },\n\n    get(proxyTarget, property, receiver) {\n      if (property === PROPERTY_PROXY_STATE) {\n        return state;\n      }\n\n      if (property === EXPRESSION_BRAND) {\n        return createMemberAccessPathExpression(state.resource, state.steps, state.index);\n      }\n\n      if (property === Symbol.toPrimitive) {\n        return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(\".\")}]`;\n      }\n\n      if (typeof property !== \"string\") {\n        return Reflect.get(proxyTarget, property, receiver);\n      }\n\n      if (property === \"toString\") {\n        return () => `[ResourceMember ${stepsToPath(state.steps).map(String).join(\".\")}]`;\n      }\n\n      if (property === \"valueOf\") {\n        return () => createMemberAccessPathExpression(state.resource, state.steps, state.index);\n      }\n\n      if (property === \"then\") {\n        return undefined;\n      }\n\n      const currentValue = getValueAtPath(state.root, stepsToPath(state.steps));\n      const segment = toPropertySegment(property, state.nav, currentValue);\n      // Pass the value at the current position so a discriminated nav\n      // can select its variant (see `resolveModelShape`).\n      const step = navigateShape(state.nav, segment, currentValue);\n      const nextArmPath = step.stamp?.armPath;\n      const nextNav = step.next;\n\n      return createPropertyProxy({\n        ...state,\n        steps: [...state.steps, { segment, armPath: nextArmPath }],\n        nav: nextNav,\n      });\n    },\n\n    set(_proxyTarget, property, value) {\n      if (typeof property !== \"string\") {\n        return false;\n      }\n\n      // A looped element (`parent.at(i)`) yields member proxies stamped with\n      // an index. Writing through one would mutate the shared for-loop body,\n      // which is not valid Bicep — `sym[i].prop = ...` cannot be expressed.\n      if (state.index !== undefined) {\n        throwLoopedElementWriteError();\n      }\n\n      setValueAtPath(\n        state.root,\n        [\n          ...stepsToPath(state.steps),\n          toPropertySegment(\n            property,\n            state.nav,\n            getValueAtPath(state.root, stepsToPath(state.steps)),\n          ),\n        ],\n        normalizeAssignedValue(value, state.resource),\n      );\n\n      return true;\n    },\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Resource member proxy\n// ---------------------------------------------------------------------------\n\nfunction isNonEnumerableOwnProperty(target: object, property: string): boolean {\n  const descriptor = Reflect.getOwnPropertyDescriptor(target, property);\n  return descriptor?.enumerable === false;\n}\n\nfunction hasOwnOrPrototypeProperty(target: object, property: string): boolean {\n  let current: object | null = target;\n\n  while (current !== null) {\n    if (Object.prototype.hasOwnProperty.call(current, property)) {\n      return true;\n    }\n    current = Object.getPrototypeOf(current);\n  }\n\n  return false;\n}\n\nexport function createResourceMemberProxy<TValue>(\n  source: ResourceProxySource,\n  path: readonly PropertySegment[],\n): Expression<TValue> & TValue {\n  // Seed nav from the resource's shape (if any). Walk the existing\n  // path, transitioning nav at each step so every segment is stamped\n  // correctly. Pre-existing callers pass paths they built manually, so\n  // we treat unknown navigations as passthrough.\n  const rootShape = getResourceShape(source.resource);\n  let nav: NavShape = rootShape;\n  const steps: PropertyStep[] = [];\n  for (const segment of path) {\n    const step = navigateShape(nav, segment, getValueAtPath(source.root, stepsToPath(steps)));\n    steps.push({ segment, armPath: step.stamp?.armPath });\n    nav = step.next;\n  }\n\n  return createPropertyProxy({\n    ...source,\n    steps,\n    nav,\n  }) as Expression<TValue> & TValue;\n}\n\nfunction getResourceShape(resource: Resource): FlatModelShape | undefined {\n  // Look up by (armType, apiVersion), letting the registry resolve\n  // any discriminated variant from the instance's own state (typically\n  // the hardcoded `name` literal each variant class sets).\n  const state = (resource as unknown as { [RAW_RESOURCE_HANDLE]: Record<string, unknown> })[\n    RAW_RESOURCE_HANDLE\n  ];\n  return getShape(resource.type, resource.apiVersion, state);\n}\n\n// ---------------------------------------------------------------------------\n// Resource-level proxy\n// ---------------------------------------------------------------------------\n\nexport function createResourceProxy<\n  TType extends string,\n  TResource extends Resource<TType> & object,\n>(resource: TResource): TResource {\n  function getBackingResourceData(target: TResource): Record<string, unknown> {\n    return Reflect.get(target, RAW_RESOURCE_HANDLE) as Record<string, unknown>;\n  }\n\n  const proxy = new Proxy(resource, {\n    ownKeys(target) {\n      return Array.from(\n        new Set([\n          ...Reflect.ownKeys(target),\n          ...Reflect.ownKeys(getBackingResourceData(target)).filter(\n            (key) => key !== RAW_RESOURCE_HANDLE,\n          ),\n        ]),\n      );\n    },\n\n    getOwnPropertyDescriptor(target, property) {\n      const targetDescriptor = Reflect.getOwnPropertyDescriptor(target, property);\n      if (targetDescriptor !== undefined) {\n        return targetDescriptor;\n      }\n\n      const backing = getBackingResourceData(target);\n      if (Object.prototype.hasOwnProperty.call(backing, property)) {\n        return { enumerable: true, configurable: true, writable: true };\n      }\n\n      return undefined;\n    },\n\n    get(target, property, receiver) {\n      if (typeof property !== \"string\") {\n        return Reflect.get(target, property, receiver);\n      }\n\n      if (property === \"then\") {\n        return Reflect.get(target, property, receiver);\n      }\n\n      if (\n        hasOwnOrPrototypeProperty(target, property) ||\n        isNonEnumerableOwnProperty(target, property)\n      ) {\n        return Reflect.get(target, property, receiver);\n      }\n\n      const rootState = unwrapResourceHandle(proxy) as Record<string, unknown>;\n      const rootShape = getResourceShape(target);\n      const segment = toPropertySegment(property, rootShape, rootState);\n      const step = navigateShape(rootShape, segment, rootState);\n      const armPath = step.stamp?.armPath;\n      const nav = step.next;\n\n      return createPropertyProxy({\n        resource: proxy,\n        root: rootState,\n        steps: [{ segment, armPath }],\n        nav,\n      });\n    },\n\n    set(target, property, value, receiver) {\n      if (typeof property !== \"string\") {\n        return Reflect.set(target, property, value, receiver);\n      }\n\n      if (\n        hasOwnOrPrototypeProperty(target, property) ||\n        isNonEnumerableOwnProperty(target, property)\n      ) {\n        return Reflect.set(target, property, value, receiver);\n      }\n\n      setValueAtPath(\n        unwrapResourceHandle(proxy) as Record<string, unknown>,\n        [toPropertySegment(property, getResourceShape(target), unwrapResourceHandle(proxy))],\n        normalizeAssignedValue(value, proxy),\n      );\n      return true;\n    },\n  });\n\n  return proxy;\n}\n\n// ---------------------------------------------------------------------------\n// Resource handle detection\n// ---------------------------------------------------------------------------\n\nfunction isResourceHandle(value: unknown): value is Resource {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as Record<symbol, unknown>)[RESOURCE_BRAND] === true\n  );\n}\n\nexport function unwrapResourceHandle<T extends ResourceDeclaration>(resource: T): T {\n  const maybeRaw = Reflect.get(resource as object, RAW_RESOURCE_HANDLE);\n\n  if (maybeRaw === undefined) {\n    return resource;\n  }\n\n  return maybeRaw as T;\n}\n\n// ---------------------------------------------------------------------------\n// Indexed resource proxy — for `LoopedResource.at(i)` / `.current()`\n// ---------------------------------------------------------------------------\n\n/**\n * Returns a passthrough proxy over `resource` that carries an \"index\"\n * expression alongside the wrapped resource. Two purposes:\n *\n * 1. **Property reads** — ARM getters on the underlying `Resource` funnel\n *    through `this.expr(...)`. The indexed proxy intercepts `expr` and\n *    threads `resourceIndexExpression` into the member proxy so that reads\n *    render as `sym[index].<path>` on the wire. Direct data-property reads\n *    like `.type` / `.apiVersion` / `.condition` / `.existing` fall through\n *    unchanged (they are authoring/type metadata, not ARM reads).\n *\n * 2. **Child parent context** — passing `parents.at(0)` as the first\n *    argument to a child constructor must (a) let the child register into\n *    the raw parent's tree, and (b) record the index so the serializer can\n *    emit `parent: parentSym[i]`.\n *    This proxy passes framework members (`children`, `deploymentContext`,\n *    `_localDeploymentContext`, `hasDeploymentContext`, `.parent`, `.self`,\n *    ...) through unchanged so the base `Resource` constructor's\n *    interaction with `context` works exactly as it would with the raw\n *    parent. `PROXY_INDEX_REF` and `INDEXED_PROXY_TARGET` expose the\n *    index and the raw target to the base `Resource` constructor.\n *\n * The `index` can be a literal number, a literal string, or any expression\n * (typically a loop's `.index` symbolic value). It is unwrapped from any\n * `Expression<T>` proxy at construction time so downstream code stores a\n * primitive or an `ExpressionNode`, never an `Expression` proxy.\n *\n * **The indexed proxy is an ephemeral wrapper, not a tree node.** A fresh\n * proxy is minted per `.at(i)` call and is not stored in\n * any `parent.children` array; only the raw outer resource proxy\n * participates in the ProvisioningComponent tree. When a child is created with an\n * indexed proxy as `context`, `ProvisioningComponent`'s ctor writes\n * `this.parent = indexedProxy` briefly, but the base `Resource` ctor then overwrites\n * `this.parent` back to the raw parent (via `INDEXED_PROXY_TARGET`) so the\n * tree only ever references raw resource proxies. The indexed wrapper is\n * garbage-collectable once the child ctor returns; its sole job is to\n * carry the index through construction into `state.parentIndex`.\n */\n/**\n * Static type an indexed proxy exposes, derived from the declaration it\n * wraps. A `LoopedResource<T>` narrows to `T` — the concrete resource\n * type — so `parent.at(i)` exposes the full ARM and child-accessor\n * surface, resolved element-scoped at runtime. Any scalar {@link Resource}\n * yields itself.\n */\ntype IndexedProxyOf<D extends ResourceDeclaration> = D extends LoopedResource<infer T> ? T : D;\n\nfunction throwLoopedElementWriteError(): never {\n  throw new Error(\n    \"Cannot assign to a property of a looped resource declaration. Individual loop iterations cannot be mutated. Set the property in the declaration passed to `fromLoop(loop, ...)`\",\n  );\n}\n\nexport function createIndexedResourceProxy<D extends ResourceDeclaration>(\n  resource: D,\n  index: ExpressionOrValue<number>,\n): IndexedProxyOf<D> {\n  const resourceIndexExpression: ArrayAccessIndex = isExpression(index)\n    ? unwrapExpression(index as Expression<number>)\n    : index;\n  const root = unwrapResourceHandle(resource) as unknown as Record<string, unknown>;\n\n  // A looped declaration (`LoopedResource`) exposes the concrete subclass\n  // ctor it wraps via `wrappedCtor`; its prototype carries the subclass's\n  // ARM accessors (`.sku`, `.properties.*`, `.id`, `.name`). The `get` trap\n  // below walks this prototype to resolve those reads rooted at\n  // `sym[index]`. A scalar `Resource` has no `wrappedCtor` — it already\n  // carries those accessors on its own prototype, so `subclassProto` stays\n  // `undefined` and lookups resolve via the target's own chain.\n  const subclassProto = (resource as { readonly wrappedCtor?: { readonly prototype: object } })\n    .wrappedCtor?.prototype;\n\n  return new Proxy(resource as object, {\n    // Deliberately NO `getPrototypeOf` trap. Exposing the subclass\n    // prototype here would make `proxy instanceof Subclass` report `true`,\n    // invoking subclass getters/methods against the bare `LoopedResource`\n    // target (which lacks the subclass's own instance slots). Property\n    // reads and writes don't need it: the `get`/`set` traps below have\n    // their own `subclassProto` fallbacks that run accessors with\n    // `this = receiver` (the proxy) so `this.expr(...)` resolves against the\n    // indexed element.\n    get(target, property, receiver) {\n      // Reveal-only symbols consulted by the base `Resource` constructor\n      // and by serialization; both are marker keys with no runtime prototype\n      // representation on plain resources.\n      if (property === PROXY_INDEX_REF) return resourceIndexExpression;\n      if (property === INDEXED_PROXY_TARGET) return target;\n\n      // Intercept the single funnel for ARM reads. `this.expr(...path)` is\n      // the getter body used by every generated ARM property (`.name`,\n      // `.id`, `.properties.*`, etc.). Route it through\n      // `createResourceMemberProxy` with our `resourceIndexExpression` so\n      // the whole emitted expression roots at `sym[index]` instead of `sym`.\n      if (property === \"expr\") {\n        return function boundIndexedExpr(...path: readonly PropertySegment[]): unknown {\n          return createResourceMemberProxy(\n            {\n              resource: target as Resource,\n              root,\n              index: resourceIndexExpression,\n            },\n            path,\n          );\n        };\n      }\n\n      // Block ARM property writes on a looped element. Every generated ARM\n      // setter (`set sku`, `set properties`, `set name`, …) funnels through\n      // `this.setProperty(...)`, so intercepting that single method turns\n      // `parent.at(i).sku = ...` into a clear error.\n      if (property === \"setProperty\") {\n        return throwLoopedElementWriteError;\n      }\n\n      // First try the target's own chain. Two subtleties:\n      //\n      // 1. Getters (`.type`, `.apiVersion`, `.children`, `.parent`, …) must\n      //    run with `this = target` so they see the raw resource's own\n      //    properties — including class private fields (`#…`). Passing the\n      //    proxy as `receiver` would cause private-field access inside a\n      //    getter to fail because the proxy has no such slot.\n      // 2. Subclass methods need `this = target` for the same reason — private\n      //    fields again — so\n      //    we return a bound wrapper. This means `ctx.method === ctx.method`\n      //    yields `false` between reads; acceptable trade-off given no\n      //    caller relies on function identity on an indexed proxy.\n      if (property in target) {\n        const value = Reflect.get(target, property, target);\n        return typeof value === \"function\" ? value.bind(target) : value;\n      }\n\n      // Fall through to `subclassProto` for subclass-specific getters\n      // (e.g. `.id`, `.name`, `.sku`) when wrapping a `LoopedResource`.\n      // Getters must run with `this = receiver` (the proxy) so their\n      // `this.expr(...)` calls hit our intercept above, yielding an\n      // expression rooted at `sym[index]`. Methods bind to `target` to\n      // stay consistent with the passthrough branch above.\n      if (subclassProto !== undefined) {\n        let proto: object | null = subclassProto;\n        while (proto !== null && proto !== Object.prototype) {\n          const descriptor = Object.getOwnPropertyDescriptor(proto, property);\n          if (descriptor !== undefined) {\n            if (descriptor.get !== undefined) {\n              return descriptor.get.call(receiver);\n            }\n            const value = descriptor.value;\n            return typeof value === \"function\" ? value.bind(target) : value;\n          }\n          proto = Object.getPrototypeOf(proto);\n        }\n      }\n\n      return undefined;\n    },\n\n    // Route writes to an ARM property setter with `this = receiver` (the\n    // proxy), allowing its `setProperty` call to hit the rejection above.\n    // Falls back to a plain write on the raw target.\n    set(target, property, value, receiver) {\n      if (subclassProto !== undefined) {\n        let proto: object | null = subclassProto;\n        while (proto !== null && proto !== Object.prototype) {\n          const descriptor = Object.getOwnPropertyDescriptor(proto, property);\n          if (descriptor !== undefined) {\n            if (descriptor.set !== undefined) {\n              descriptor.set.call(receiver, value);\n              return true;\n            }\n            break;\n          }\n          proto = Object.getPrototypeOf(proto);\n        }\n      }\n      return Reflect.set(target, property, value, target);\n    },\n  }) as IndexedProxyOf<D>;\n}\n"]}

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

@@ -0,0 +1,23 @@
+import type { ProvisioningComponent } from "../provisioning-component.js";
+import type { LoopedResource, Resource } from "./resource.js";
+import type { ResourceCtor } from "./resource-registry.js";
+/** Options accepted by the `Stack` resource queries. */
+export interface QueryOptions {
+    /**
+     * Whether to walk the stack's entire subtree (default `true`) or only its
+     * **direct children** (`false`).
+     */
+    readonly recursive?: boolean;
+}
+/** Scalar (un-looped) resource declarations. */
+export declare function getResources(root: ProvisioningComponent, typeOrOptions?: ResourceCtor<Resource> | QueryOptions, maybeOptions?: QueryOptions): Resource[];
+/** Loop-expanded resource declarations (`Ctor.fromLoop(...)`). */
+export declare function getLoopedResources(root: ProvisioningComponent, typeOrOptions?: ResourceCtor<Resource> | QueryOptions, maybeOptions?: QueryOptions): LoopedResource<Resource>[];
+/**
+ * First scalar resource of `type` whose literal name equals `name`, or
+ * `undefined`. `deref` resolves the name's expression proxy to its literal
+ * (a `Resource`'s `name` is an `Expression`, so `r.name === name` is always
+ * false without it).
+ */
+export declare function getResource<T extends Resource>(root: ProvisioningComponent, type: ResourceCtor<T>, name: string, options?: QueryOptions): T | undefined;
+//# sourceMappingURL=resource-query.d.ts.map

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

@@ -0,0 +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"}