@azure/provisioning-core 1.0.0-beta.1

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

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

package/dist/esm/fn.d.ts

@@ -0,0 +1,194 @@
+import { type Expression, type ExpressionOrValue } from "./expression/expressions.js";
+/** Adds two numbers as a deploy-time expression. */
+export declare function add(left: ExpressionOrValue<number>, right: ExpressionOrValue<number>): Expression<number>;
+/** Subtracts the right operand from the left at deployment time. */
+export declare function sub(left: ExpressionOrValue<number>, right: ExpressionOrValue<number>): Expression<number>;
+/** Multiplies two numbers at deployment time. */
+export declare function mul(left: ExpressionOrValue<number>, right: ExpressionOrValue<number>): Expression<number>;
+/** Divides the left operand by the right at deployment time. */
+export declare function div(left: ExpressionOrValue<number>, right: ExpressionOrValue<number>): Expression<number>;
+/** Returns the remainder of dividing the left operand by the right. */
+export declare function mod(left: ExpressionOrValue<number>, right: ExpressionOrValue<number>): Expression<number>;
+/** Negates a number at deployment time. */
+export declare function neg(value: ExpressionOrValue<number>): Expression<number>;
+/** Tests whether two values are equal at deployment time. */
+export declare function eq(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Tests whether two values differ at deployment time. */
+export declare function neq(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Tests whether the left value is greater than the right value. */
+export declare function gt(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Tests whether the left value is less than the right value. */
+export declare function lt(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Tests whether the left value is greater than or equal to the right value. */
+export declare function gte(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Tests whether the left value is less than or equal to the right value. */
+export declare function lte(left: ExpressionOrValue<unknown>, right: ExpressionOrValue<unknown>): Expression<boolean>;
+/**
+ * Logical AND.  Accepts 1 … N operands and folds left:
+ * `and(a, b, c)` → `(a && b) && c`
+ *
+ * A single operand is returned as an `Expression<boolean>` (identity).
+ */
+export declare function and(...conditions: ExpressionOrValue<boolean>[]): Expression<boolean>;
+/**
+ * Logical OR.  Accepts 1 … N operands and folds left:
+ * `or(a, b, c)` → `(a || b) || c`
+ */
+export declare function or(...conditions: ExpressionOrValue<boolean>[]): Expression<boolean>;
+/** Negates a Boolean value at deployment time. */
+export declare function not(value: ExpressionOrValue<boolean>): Expression<boolean>;
+/** Selects one of two values based on a deploy-time condition. */
+export declare function cond<T>(condition: ExpressionOrValue<boolean>, trueValue: ExpressionOrValue<T>, falseValue: ExpressionOrValue<T>): Expression<T>;
+/** Returns the left value unless it is null, otherwise the right value. */
+export declare function coalesce<T>(left: ExpressionOrValue<T>, right: ExpressionOrValue<T>): Expression<T>;
+/** Concatenates strings and expressions in a tagged template. */
+export declare function concat(strings: TemplateStringsArray, ...values: ExpressionOrValue<string>[]): Expression<string>;
+/** Concatenates string values and expressions at deployment time. */
+export declare function concat(...values: ExpressionOrValue<string>[]): Expression<string>;
+/** Returns the first `count` characters of a string. */
+export declare function take(value: ExpressionOrValue<string>, count: ExpressionOrValue<number>): Expression<string>;
+/** Converts a string to lowercase at deployment time. */
+export declare function toLower(value: ExpressionOrValue<string>): Expression<string>;
+/** Converts a string to uppercase at deployment time. */
+export declare function toUpper(value: ExpressionOrValue<string>): Expression<string>;
+/** Returns part of a string, optionally starting at `start` for `count` characters. */
+export declare function substring(value: ExpressionOrValue<string>, start?: ExpressionOrValue<number>, count?: ExpressionOrValue<number>): Expression<string>;
+/** Replaces occurrences of `oldValue` with `newValue` in a string. */
+export declare function replace(value: ExpressionOrValue<string>, oldValue: ExpressionOrValue<string>, newValue: ExpressionOrValue<string>): Expression<string>;
+/** Splits a string into an array at each occurrence of `delimiter`. */
+export declare function split(value: ExpressionOrValue<string>, delimiter: ExpressionOrValue<string>): Expression<string[]>;
+/** Joins array elements into a string separated by `delimiter`. */
+export declare function join(values: ExpressionOrValue<unknown[]>, delimiter: ExpressionOrValue<string>): Expression<string>;
+/** Removes leading and trailing whitespace from a string. */
+export declare function trim(value: ExpressionOrValue<string>): Expression<string>;
+/** Tests whether a string begins with `prefix`. */
+export declare function startsWith(value: ExpressionOrValue<string>, prefix: ExpressionOrValue<string>): Expression<boolean>;
+/** Tests whether a string ends with `suffix`. */
+export declare function endsWith(value: ExpressionOrValue<string>, suffix: ExpressionOrValue<string>): Expression<boolean>;
+/** Encodes a string as Base64 at deployment time. */
+export declare function base64(value: ExpressionOrValue<string>): Expression<string>;
+/** Decodes Base64-encoded JSON into a value at deployment time. */
+export declare function base64ToJson(value: ExpressionOrValue<string>): Expression<unknown>;
+/** Formats a string using indexed placeholders and the supplied values. */
+export declare function format(formatString: ExpressionOrValue<string>, ...values: ExpressionOrValue<unknown>[]): Expression<string>;
+/** Returns the last index of `searchString` within a string. */
+export declare function lastIndexOf(value: ExpressionOrValue<string>, searchString: ExpressionOrValue<string>): Expression<number>;
+/** Creates a deterministic string from the supplied values. */
+export declare function uniqueString(...values: ExpressionOrValue<string>[]): Expression<string>;
+/** Creates a deterministic GUID from the supplied values. */
+export declare function guid(...values: ExpressionOrValue<string>[]): Expression<string>;
+/** Constructs a resource ID at the current deployment scope. */
+export declare function resourceId(type: ExpressionOrValue<string>, ...names: ExpressionOrValue<string>[]): Expression<string>;
+/** Constructs an ID for a subscription-scoped resource. */
+export declare function subscriptionResourceId(type: ExpressionOrValue<string>, ...names: ExpressionOrValue<string>[]): Expression<string>;
+/** Constructs an extension resource ID relative to `baseId`. */
+export declare function extensionResourceId(baseId: ExpressionOrValue<string>, type: ExpressionOrValue<string>, ...names: ExpressionOrValue<string>[]): Expression<string>;
+/** Converts a value to an integer at deployment time. */
+export declare function int(value: ExpressionOrValue<unknown>): Expression<number>;
+/** Returns the smallest of the supplied numbers. */
+export declare function min(...values: ExpressionOrValue<number>[]): Expression<number>;
+/** Returns the largest of the supplied numbers. */
+export declare function max(...values: ExpressionOrValue<number>[]): Expression<number>;
+/** Returns the length of a string, array, or object at deployment time. */
+export declare function length(value: ExpressionOrValue<unknown>): Expression<number>;
+/** Tests whether a string, array, or object is empty. */
+export declare function empty(value: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Returns the first element of an array. */
+export declare function first<T>(arr: ExpressionOrValue<T[]>): Expression<T>;
+/** Returns the last element of an array. */
+export declare function last<T>(arr: ExpressionOrValue<T[]>): Expression<T>;
+/** Tests whether a string, array, or object contains a value or key. */
+export declare function contains(container: ExpressionOrValue<unknown>, value: ExpressionOrValue<unknown>): Expression<boolean>;
+/** Returns the first index of `value` in an array, or -1 if absent. */
+export declare function indexOf<T>(arr: ExpressionOrValue<T[]>, value: ExpressionOrValue<T>): Expression<number>;
+/** Flattens one level of nested arrays. */
+export declare function flatten<T>(arr: ExpressionOrValue<T[][]>): Expression<T[]>;
+/** Returns the intersection of two arrays or objects. */
+export declare function intersect<T, U>(a: ExpressionOrValue<T>, b: ExpressionOrValue<U>): Expression<T & U>;
+/** Returns the union of two arrays, with elements from either input. */
+export declare function union<TElement, UElement>(a: ExpressionOrValue<readonly TElement[]>, b: ExpressionOrValue<readonly UElement[]>): Expression<(TElement | UElement)[]>;
+/** Returns the union of two objects, with properties from both inputs. */
+export declare function union<T extends object, U extends object>(a: T extends readonly unknown[] ? never : ExpressionOrValue<T>, b: U extends readonly unknown[] ? never : ExpressionOrValue<U>): Expression<T & U>;
+/** Skips the first `count` elements of an array. */
+export declare function skip<T>(arr: ExpressionOrValue<T[]>, count: ExpressionOrValue<number>): Expression<T[]>;
+/** Returns an array's elements in reverse order. */
+export declare function reverse<T>(arr: ExpressionOrValue<T[]>): Expression<T[]>;
+/** Parses JSON text into a deploy-time value. */
+export declare function json(value: ExpressionOrValue<string>): Expression<unknown>;
+/** Returns the property names of an object. */
+export declare function objectKeys(obj: ExpressionOrValue<object>): Expression<string[]>;
+/** Returns an object's key/value pairs as an array. */
+export declare function items(obj: ExpressionOrValue<object>): Expression<unknown[]>;
+/**
+ * Typed shape of Bicep's `subscription()` runtime function. Only the
+ * properties currently surfaced are listed; extend as needed.
+ */
+export interface SubscriptionScope {
+    readonly subscriptionId: string;
+    readonly tenantId: string;
+}
+/**
+ * Typed shape of Bicep's `resourceGroup()` runtime function. Only the
+ * properties currently surfaced are listed; extend as needed.
+ */
+export interface ResourceGroupScope {
+    readonly name: string;
+    readonly location: string;
+    readonly id: string;
+}
+/**
+ * Typed shape of Bicep's `tenant()` runtime function. Only the properties
+ * currently surfaced are listed; extend as needed.
+ */
+export interface TenantScope {
+    readonly tenantId: string;
+    readonly id: string;
+}
+/**
+ * Typed shape of Bicep's `managementGroup()` runtime function. Only the
+ * properties currently surfaced are listed; extend as needed.
+ */
+export interface ManagementGroupScope {
+    readonly name: string;
+    readonly id: string;
+}
+/**
+ * Bicep `subscription()` / `subscription(subscriptionId)`.
+ *
+ * - Zero-arg form returns details about the current subscription.
+ * - One-arg form returns a scope object for setting `scope:` on a module
+ *   or extension resource.
+ */
+export declare function subscription(): Expression<SubscriptionScope>;
+export declare function subscription(subscriptionId: ExpressionOrValue<string>): Expression<SubscriptionScope>;
+/**
+ * Bicep `resourceGroup()` / `resourceGroup(name)` /
+ * `resourceGroup(subscriptionId, name)`.
+ *
+ * - Zero-arg form returns details about the current resource group.
+ * - One- and two-arg forms return a scope object for setting `scope:` on a
+ *   module or extension resource.
+ */
+export declare function resourceGroup(): Expression<ResourceGroupScope>;
+export declare function resourceGroup(name: ExpressionOrValue<string>): Expression<ResourceGroupScope>;
+export declare function resourceGroup(subscriptionId: ExpressionOrValue<string>, name: ExpressionOrValue<string>): Expression<ResourceGroupScope>;
+/**
+ * Bicep `tenant()`. Returns details about the current tenant (or a scope
+ * object when placed in `scope:`). Takes no arguments.
+ */
+export declare function tenant(): Expression<TenantScope>;
+/**
+ * Bicep `managementGroup()` / `managementGroup(identifier)`.
+ *
+ * - Zero-arg form is only valid in management-group-scope deployments and
+ *   returns details about the current management group.
+ * - One-arg form returns a scope object for setting `scope:` on a module
+ *   or extension resource.
+ */
+export declare function managementGroup(): Expression<ManagementGroupScope>;
+export declare function managementGroup(identifier: ExpressionOrValue<string>): Expression<ManagementGroupScope>;
+/** Bicep `deployment()`. Returns information about the current deployment. */
+export declare function deployment(): Expression<unknown>;
+/** Bicep `environment()`. Returns information about the Azure environment. */
+export declare function environment(): Expression<unknown>;
+//# sourceMappingURL=fn.d.ts.map

package/dist/esm/fn.d.ts.map

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

package/dist/esm/fn.js

@@ -0,0 +1,334 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+import { createBinaryExpression, createFunctionCallExpression, createTernaryExpression, createUnaryExpression, isExpression, } from "./expression/expressions.js";
+// ---------------------------------------------------------------------------
+// Arithmetic operators
+// ---------------------------------------------------------------------------
+/** Adds two numbers as a deploy-time expression. */
+export function add(left, right) {
+    return createBinaryExpression("+", left, right);
+}
+/** Subtracts the right operand from the left at deployment time. */
+export function sub(left, right) {
+    return createBinaryExpression("-", left, right);
+}
+/** Multiplies two numbers at deployment time. */
+export function mul(left, right) {
+    return createBinaryExpression("*", left, right);
+}
+/** Divides the left operand by the right at deployment time. */
+export function div(left, right) {
+    return createBinaryExpression("/", left, right);
+}
+/** Returns the remainder of dividing the left operand by the right. */
+export function mod(left, right) {
+    return createBinaryExpression("%", left, right);
+}
+/** Negates a number at deployment time. */
+export function neg(value) {
+    return createUnaryExpression("-", value);
+}
+// ---------------------------------------------------------------------------
+// Comparison operators
+// ---------------------------------------------------------------------------
+/** Tests whether two values are equal at deployment time. */
+export function eq(left, right) {
+    return createBinaryExpression("==", left, right);
+}
+/** Tests whether two values differ at deployment time. */
+export function neq(left, right) {
+    return createBinaryExpression("!=", left, right);
+}
+/** Tests whether the left value is greater than the right value. */
+export function gt(left, right) {
+    return createBinaryExpression(">", left, right);
+}
+/** Tests whether the left value is less than the right value. */
+export function lt(left, right) {
+    return createBinaryExpression("<", left, right);
+}
+/** Tests whether the left value is greater than or equal to the right value. */
+export function gte(left, right) {
+    return createBinaryExpression(">=", left, right);
+}
+/** Tests whether the left value is less than or equal to the right value. */
+export function lte(left, right) {
+    return createBinaryExpression("<=", left, right);
+}
+// ---------------------------------------------------------------------------
+// Boolean operators
+// ---------------------------------------------------------------------------
+/**
+ * Logical AND.  Accepts 1 … N operands and folds left:
+ * `and(a, b, c)` → `(a && b) && c`
+ *
+ * A single operand is returned as an `Expression<boolean>` (identity).
+ */
+export function and(...conditions) {
+    if (conditions.length === 0) {
+        throw new Error("and() requires at least one argument");
+    }
+    if (conditions.length === 1) {
+        const c = conditions[0];
+        if (isExpression(c))
+            return c;
+        return createUnaryExpression("!", createUnaryExpression("!", c));
+    }
+    let result = conditions[0];
+    for (let i = 1; i < conditions.length; i++) {
+        result = createBinaryExpression("&&", result, conditions[i]);
+    }
+    return result;
+}
+/**
+ * Logical OR.  Accepts 1 … N operands and folds left:
+ * `or(a, b, c)` → `(a || b) || c`
+ */
+export function or(...conditions) {
+    if (conditions.length === 0) {
+        throw new Error("or() requires at least one argument");
+    }
+    if (conditions.length === 1) {
+        const c = conditions[0];
+        if (isExpression(c))
+            return c;
+        return createUnaryExpression("!", createUnaryExpression("!", c));
+    }
+    let result = conditions[0];
+    for (let i = 1; i < conditions.length; i++) {
+        result = createBinaryExpression("||", result, conditions[i]);
+    }
+    return result;
+}
+/** Negates a Boolean value at deployment time. */
+export function not(value) {
+    return createUnaryExpression("!", value);
+}
+// ---------------------------------------------------------------------------
+// Conditional operators
+// ---------------------------------------------------------------------------
+/** Selects one of two values based on a deploy-time condition. */
+export function cond(condition, trueValue, falseValue) {
+    return createTernaryExpression(condition, trueValue, falseValue);
+}
+/** Returns the left value unless it is null, otherwise the right value. */
+export function coalesce(left, right) {
+    return createBinaryExpression("??", left, right);
+}
+// ---------------------------------------------------------------------------
+// String functions
+// ---------------------------------------------------------------------------
+// Detects the `[TemplateStringsArray, ...values]` shape produced by a
+// tagged-template call. Used by `concat` to support both `concat("a", "b")`
+// and `` concat`a${x}b` `` forms.
+function isTemplateLiteralArgs(args) {
+    return Array.isArray(args[0]) && "raw" in args[0] && Array.isArray(args[0].raw);
+}
+// Interleaves a tagged-template's static `strings` with its dynamic `values`,
+// dropping empty leading/trailing static segments so the resulting array is
+// suitable as `concat()` arguments.
+function interleaveTemplateLiteralArgs(strings, values) {
+    const result = [];
+    for (let i = 0; i < strings.length; i++) {
+        const s = strings[i];
+        if (s !== "") {
+            result.push(s);
+        }
+        if (i < values.length) {
+            result.push(values[i]);
+        }
+    }
+    return result;
+}
+export function concat(...args) {
+    if (isTemplateLiteralArgs(args)) {
+        const [strings, ...values] = args;
+        return createFunctionCallExpression("concat", interleaveTemplateLiteralArgs(strings, values));
+    }
+    return createFunctionCallExpression("concat", args);
+}
+/** Returns the first `count` characters of a string. */
+export function take(value, count) {
+    return createFunctionCallExpression("take", [value, count]);
+}
+/** Converts a string to lowercase at deployment time. */
+export function toLower(value) {
+    return createFunctionCallExpression("toLower", [value]);
+}
+/** Converts a string to uppercase at deployment time. */
+export function toUpper(value) {
+    return createFunctionCallExpression("toUpper", [value]);
+}
+/** Returns part of a string, optionally starting at `start` for `count` characters. */
+export function substring(value, start, count) {
+    const args = [value];
+    if (start !== undefined)
+        args.push(start);
+    if (count !== undefined)
+        args.push(count);
+    return createFunctionCallExpression("substring", args);
+}
+/** Replaces occurrences of `oldValue` with `newValue` in a string. */
+export function replace(value, oldValue, newValue) {
+    return createFunctionCallExpression("replace", [value, oldValue, newValue]);
+}
+/** Splits a string into an array at each occurrence of `delimiter`. */
+export function split(value, delimiter) {
+    return createFunctionCallExpression("split", [value, delimiter]);
+}
+/** Joins array elements into a string separated by `delimiter`. */
+export function join(values, delimiter) {
+    return createFunctionCallExpression("join", [values, delimiter]);
+}
+/** Removes leading and trailing whitespace from a string. */
+export function trim(value) {
+    return createFunctionCallExpression("trim", [value]);
+}
+/** Tests whether a string begins with `prefix`. */
+export function startsWith(value, prefix) {
+    return createFunctionCallExpression("startsWith", [value, prefix]);
+}
+/** Tests whether a string ends with `suffix`. */
+export function endsWith(value, suffix) {
+    return createFunctionCallExpression("endsWith", [value, suffix]);
+}
+/** Encodes a string as Base64 at deployment time. */
+export function base64(value) {
+    return createFunctionCallExpression("base64", [value]);
+}
+/** Decodes Base64-encoded JSON into a value at deployment time. */
+export function base64ToJson(value) {
+    return createFunctionCallExpression("base64ToJson", [value]);
+}
+/** Formats a string using indexed placeholders and the supplied values. */
+export function format(formatString, ...values) {
+    return createFunctionCallExpression("format", [formatString, ...values]);
+}
+/** Returns the last index of `searchString` within a string. */
+export function lastIndexOf(value, searchString) {
+    return createFunctionCallExpression("lastIndexOf", [value, searchString]);
+}
+// ---------------------------------------------------------------------------
+// Unique / ID functions
+// ---------------------------------------------------------------------------
+/** Creates a deterministic string from the supplied values. */
+export function uniqueString(...values) {
+    return createFunctionCallExpression("uniqueString", values);
+}
+/** Creates a deterministic GUID from the supplied values. */
+export function guid(...values) {
+    return createFunctionCallExpression("guid", values);
+}
+/** Constructs a resource ID at the current deployment scope. */
+export function resourceId(type, ...names) {
+    return createFunctionCallExpression("resourceId", [type, ...names]);
+}
+/** Constructs an ID for a subscription-scoped resource. */
+export function subscriptionResourceId(type, ...names) {
+    return createFunctionCallExpression("subscriptionResourceId", [type, ...names]);
+}
+/** Constructs an extension resource ID relative to `baseId`. */
+export function extensionResourceId(baseId, type, ...names) {
+    return createFunctionCallExpression("extensionResourceId", [baseId, type, ...names]);
+}
+// ---------------------------------------------------------------------------
+// Numeric functions
+// ---------------------------------------------------------------------------
+/** Converts a value to an integer at deployment time. */
+export function int(value) {
+    return createFunctionCallExpression("int", [value]);
+}
+/** Returns the smallest of the supplied numbers. */
+export function min(...values) {
+    return createFunctionCallExpression("min", values);
+}
+/** Returns the largest of the supplied numbers. */
+export function max(...values) {
+    return createFunctionCallExpression("max", values);
+}
+// ---------------------------------------------------------------------------
+// Array / collection functions
+// ---------------------------------------------------------------------------
+/** Returns the length of a string, array, or object at deployment time. */
+export function length(value) {
+    return createFunctionCallExpression("length", [value]);
+}
+/** Tests whether a string, array, or object is empty. */
+export function empty(value) {
+    return createFunctionCallExpression("empty", [value]);
+}
+/** Returns the first element of an array. */
+export function first(arr) {
+    return createFunctionCallExpression("first", [arr]);
+}
+/** Returns the last element of an array. */
+export function last(arr) {
+    return createFunctionCallExpression("last", [arr]);
+}
+/** Tests whether a string, array, or object contains a value or key. */
+export function contains(container, value) {
+    return createFunctionCallExpression("contains", [container, value]);
+}
+/** Returns the first index of `value` in an array, or -1 if absent. */
+export function indexOf(arr, value) {
+    return createFunctionCallExpression("indexOf", [arr, value]);
+}
+/** Flattens one level of nested arrays. */
+export function flatten(arr) {
+    return createFunctionCallExpression("flatten", [arr]);
+}
+/** Returns the intersection of two arrays or objects. */
+export function intersect(a, b) {
+    return createFunctionCallExpression("intersection", [a, b]);
+}
+export function union(a, b) {
+    return createFunctionCallExpression("union", [a, b]);
+}
+/** Skips the first `count` elements of an array. */
+export function skip(arr, count) {
+    return createFunctionCallExpression("skip", [arr, count]);
+}
+/** Returns an array's elements in reverse order. */
+export function reverse(arr) {
+    return createFunctionCallExpression("reverse", [arr]);
+}
+// ---------------------------------------------------------------------------
+// Object functions
+// ---------------------------------------------------------------------------
+/** Parses JSON text into a deploy-time value. */
+export function json(value) {
+    return createFunctionCallExpression("json", [value]);
+}
+/** Returns the property names of an object. */
+export function objectKeys(obj) {
+    return createFunctionCallExpression("objectKeys", [obj]);
+}
+/** Returns an object's key/value pairs as an array. */
+export function items(obj) {
+    return createFunctionCallExpression("items", [obj]);
+}
+export function subscription(subscriptionId) {
+    return createFunctionCallExpression("subscription", subscriptionId === undefined ? [] : [subscriptionId]);
+}
+export function resourceGroup(...args) {
+    return createFunctionCallExpression("resourceGroup", args);
+}
+/**
+ * Bicep `tenant()`. Returns details about the current tenant (or a scope
+ * object when placed in `scope:`). Takes no arguments.
+ */
+export function tenant() {
+    return createFunctionCallExpression("tenant", []);
+}
+export function managementGroup(identifier) {
+    return createFunctionCallExpression("managementGroup", identifier === undefined ? [] : [identifier]);
+}
+/** Bicep `deployment()`. Returns information about the current deployment. */
+export function deployment() {
+    return createFunctionCallExpression("deployment", []);
+}
+/** Bicep `environment()`. Returns information about the Azure environment. */
+export function environment() {
+    return createFunctionCallExpression("environment", []);
+}
+//# sourceMappingURL=fn.js.map