@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/build/v4/expression/evaluateExpression.d.ts

@@ -0,0 +1,55 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+/** A value the evaluator yields. */
+export type EvalValue = boolean | string;
+/** The grammar's `null` literal and declared-but-unanswered marker. */
+export declare const NULL_VALUE: unique symbol;
+/** A resolved identifier's value: a string, or `NULL_VALUE` (unanswered / absent). */
+export type ScopeValue = string | typeof NULL_VALUE;
+/** Resolved identifier map; absent names are errors, not falsy defaults. */
+export type Scope = Record<string, ScopeValue>;
+/** Engine-owned, side-effect-free whitelist function. */
+export type WhitelistFn = (...args: string[]) => string;
+/** Pure evaluator port: whitelist functions plus read-only feature flags. */
+export interface ExpressionRuntimePort {
+    /** The fixed function whitelist; `undefined` for any non-whitelisted name. */
+    functions(name: string): WhitelistFn | undefined;
+    /** The feature-flag reader behind `featureFlag('…')` (env-backed, read-only). */
+    flags(name: string): boolean;
+}
+/** Authored expression form, raw or sugar. */
+export type ExpressionNode = {
+    expr: string;
+} | {
+    equals: Record<string, string>;
+} | {
+    enum: Record<string, string[]>;
+} | {
+    anyOf: ExpressionNode[];
+} | {
+    featureFlag: string;
+} | {
+    capability: string;
+} | {
+    from: string;
+};
+/** An authored visibility / value guard node. */
+export type ConditionNode = ExpressionNode;
+/** Common authored shape for string-expression predicates such as pipeline `when`. */
+export interface ConditionalExpression {
+    comment?: string;
+    when?: string;
+}
+/** Structural check for the authored `ExpressionNode` union. */
+export declare function isExpressionNode(value: unknown): value is ExpressionNode;
+/** Evaluate a string-expression predicate; absent `when` means active. */
+export declare function evaluateConditionalWhen(conditional: ConditionalExpression, evalWhen: (expr: string) => Result<boolean, FxError>): Result<boolean, FxError>;
+/** `SystemError` names for expression evaluation failures. */
+export declare const EXPR_UNDECLARED_IDENTIFIER = "ExprUndeclaredIdentifier";
+export declare const EXPR_NON_WHITELISTED_FUNCTION = "ExprNonWhitelistedFunction";
+export declare const EXPR_PARSE_ERROR = "ExprParseError";
+/** Evaluate one authored expression against a resolved namespace. */
+export declare function evaluateExpression(node: ExpressionNode, scope: Scope, port: ExpressionRuntimePort): Result<EvalValue, FxError>;
+/** Enumerate literal feature-flag names without evaluating or short-circuiting the expression. */
+export declare function collectFeatureFlagReferences(node: ExpressionNode): Result<ReadonlySet<string>, FxError>;
+//# sourceMappingURL=evaluateExpression.d.ts.map

package/build/v4/expression/evaluateExpression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateExpression.d.ts","sourceRoot":"","sources":["../../../src/v4/expression/evaluateExpression.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAe,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAM7C,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,uEAAuE;AACvE,eAAO,MAAM,UAAU,EAAE,OAAO,MAA+B,CAAC;AAEhE,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,UAAU,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE/C,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAExD,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACjD,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,GAClC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,GAC3B;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAaxE;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,qBAAqB,EAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GACnD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAE1B;AAED,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,6BAA6B,CAAC;AACrE,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAC1E,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD,qEAAqE;AACrE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAa5B;AA4HD,kGAAkG;AAClG,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAUtC"}

package/build/v4/expression/evaluateExpression.js

@@ -0,0 +1,338 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPR_PARSE_ERROR = exports.EXPR_NON_WHITELISTED_FUNCTION = exports.EXPR_UNDECLARED_IDENTIFIER = exports.NULL_VALUE = void 0;
+exports.isExpressionNode = isExpressionNode;
+exports.evaluateConditionalWhen = evaluateConditionalWhen;
+exports.evaluateExpression = evaluateExpression;
+exports.collectFeatureFlagReferences = collectFeatureFlagReferences;
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const neverthrow_1 = require("neverthrow");
+/** Pure v4 expression evaluator. See evaluate-expression spec and ADR-0016. */
+const SOURCE = "Scaffold";
+/** The grammar's `null` literal and declared-but-unanswered marker. */
+exports.NULL_VALUE = Symbol("v4.expr.null");
+/** Structural check for the authored `ExpressionNode` union. */
+function isExpressionNode(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (typeof value.expr === "string" ||
+        typeof value.from === "string" ||
+        typeof value.featureFlag === "string" ||
+        typeof value.capability === "string" ||
+        isRecord(value.equals) ||
+        isRecord(value.enum) ||
+        Array.isArray(value.anyOf));
+}
+/** Evaluate a string-expression predicate; absent `when` means active. */
+function evaluateConditionalWhen(conditional, evalWhen) {
+    return conditional.when !== undefined ? evalWhen(conditional.when) : (0, neverthrow_1.ok)(true);
+}
+/** `SystemError` names for expression evaluation failures. */
+exports.EXPR_UNDECLARED_IDENTIFIER = "ExprUndeclaredIdentifier";
+exports.EXPR_NON_WHITELISTED_FUNCTION = "ExprNonWhitelistedFunction";
+exports.EXPR_PARSE_ERROR = "ExprParseError";
+/** Evaluate one authored expression against a resolved namespace. */
+function evaluateExpression(node, scope, port) {
+    // Keep internal parser throws behind the public Result contract.
+    try {
+        const expr = desugarToExpr(node);
+        const ast = parse(tokenize(expr));
+        const value = evalAst(ast, scope, port);
+        // In value context, declared-but-unanswered ids render as empty strings.
+        return (0, neverthrow_1.ok)(value === exports.NULL_VALUE ? "" : value);
+    }
+    catch (e) {
+        const name = e instanceof EvalError ? e.code : exports.EXPR_PARSE_ERROR;
+        const message = e instanceof Error ? e.message : String(e);
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({ source: SOURCE, name, message }));
+    }
+}
+// --- Internal parser/evaluator ---
+/** Internal-only control-flow signal converted at the public boundary. */
+class EvalError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Lower each sugar form to the single `expr` grammar. */
+function desugarToExpr(node) {
+    if ("expr" in node) {
+        return node.expr;
+    }
+    if ("from" in node) {
+        return node.from; // value context: a verbatim identifier copy
+    }
+    if ("featureFlag" in node) {
+        return `featureFlag('${node.featureFlag}')`;
+    }
+    if ("capability" in node) {
+        return `capability == '${node.capability}'`;
+    }
+    if ("equals" in node) {
+        const [key, value] = Object.entries(node.equals)[0];
+        return `${key} == '${value}'`;
+    }
+    if ("enum" in node) {
+        const [key, values] = Object.entries(node.enum)[0];
+        return values.map((v) => `${key} == '${v}'`).join(" || ");
+    }
+    // anyOf
+    return node.anyOf.map((c) => `(${desugarToExpr(c)})`).join(" || ");
+}
+function tokenize(src) {
+    const tokens = [];
+    let i = 0;
+    while (i < src.length) {
+        const c = src[i];
+        if (c === " " || c === "\t" || c === "\n" || c === "\r") {
+            i++;
+        }
+        else if (c === "(") {
+            tokens.push({ t: "lparen" });
+            i++;
+        }
+        else if (c === ")") {
+            tokens.push({ t: "rparen" });
+            i++;
+        }
+        else if (c === ",") {
+            tokens.push({ t: "comma" });
+            i++;
+        }
+        else if (c === "=" && src[i + 1] === "=") {
+            tokens.push({ t: "eq" });
+            i += 2;
+        }
+        else if (c === "!" && src[i + 1] === "=") {
+            tokens.push({ t: "ne" });
+            i += 2;
+        }
+        else if (c === "!") {
+            tokens.push({ t: "not" });
+            i++;
+        }
+        else if (c === "&" && src[i + 1] === "&") {
+            tokens.push({ t: "and" });
+            i += 2;
+        }
+        else if (c === "|" && src[i + 1] === "|") {
+            tokens.push({ t: "or" });
+            i += 2;
+        }
+        else if (c === "'") {
+            let j = i + 1;
+            let s = "";
+            while (j < src.length && src[j] !== "'") {
+                s += src[j];
+                j++;
+            }
+            if (j >= src.length) {
+                throw new EvalError(exports.EXPR_PARSE_ERROR, "unterminated string literal");
+            }
+            tokens.push({ t: "str", v: s });
+            i = j + 1;
+        }
+        else if (/[A-Za-z_]/.test(c)) {
+            let j = i;
+            let s = "";
+            while (j < src.length && /[A-Za-z0-9_]/.test(src[j])) {
+                s += src[j];
+                j++;
+            }
+            tokens.push({ t: "ident", v: s });
+            i = j;
+        }
+        else {
+            throw new EvalError(exports.EXPR_PARSE_ERROR, `unexpected character '${c}'`);
+        }
+    }
+    return tokens;
+}
+/** Enumerate literal feature-flag names without evaluating or short-circuiting the expression. */
+function collectFeatureFlagReferences(node) {
+    try {
+        const references = new Set();
+        collectFeatureFlagReferencesFromAst(parse(tokenize(desugarToExpr(node))), references);
+        return (0, neverthrow_1.ok)(references);
+    }
+    catch (e) {
+        const name = e instanceof EvalError ? e.code : exports.EXPR_PARSE_ERROR;
+        const message = e instanceof Error ? e.message : String(e);
+        return (0, neverthrow_1.err)(new teamsfx_api_1.SystemError({ source: SOURCE, name, message }));
+    }
+}
+function collectFeatureFlagReferencesFromAst(ast, references) {
+    switch (ast.k) {
+        case "call":
+            if (ast.name === "featureFlag" && ast.args[0]?.k === "str") {
+                references.add(ast.args[0].v);
+            }
+            ast.args.forEach((argument) => collectFeatureFlagReferencesFromAst(argument, references));
+            break;
+        case "eq":
+        case "and":
+        case "or":
+            collectFeatureFlagReferencesFromAst(ast.left, references);
+            collectFeatureFlagReferencesFromAst(ast.right, references);
+            break;
+        case "not":
+            collectFeatureFlagReferencesFromAst(ast.operand, references);
+            break;
+        default:
+            break;
+    }
+}
+/** Recursive-descent parse: or → and → equality → unary → primary (call | group | literal | identifier). */
+function parse(tokens) {
+    let pos = 0;
+    const peek = () => tokens[pos];
+    const eat = () => {
+        const t = tokens[pos];
+        if (!t) {
+            throw new EvalError(exports.EXPR_PARSE_ERROR, "unexpected end of expression");
+        }
+        pos++;
+        return t;
+    };
+    function parseOr() {
+        let left = parseAnd();
+        while (peek()?.t === "or") {
+            eat();
+            left = { k: "or", left, right: parseAnd() };
+        }
+        return left;
+    }
+    function parseAnd() {
+        let left = parseEquality();
+        while (peek()?.t === "and") {
+            eat();
+            left = { k: "and", left, right: parseEquality() };
+        }
+        return left;
+    }
+    function parseEquality() {
+        let left = parseUnary();
+        let op = peek();
+        while (op?.t === "eq" || op?.t === "ne") {
+            eat();
+            left = { k: "eq", left, right: parseUnary(), neg: op.t === "ne" };
+            op = peek();
+        }
+        return left;
+    }
+    function parseUnary() {
+        if (peek()?.t === "not") {
+            eat();
+            return { k: "not", operand: parseUnary() };
+        }
+        return parsePrimary();
+    }
+    function parsePrimary() {
+        const t = peek();
+        if (!t) {
+            throw new EvalError(exports.EXPR_PARSE_ERROR, "unexpected end of expression");
+        }
+        if (t.t === "lparen") {
+            eat();
+            const inner = parseOr();
+            if (peek()?.t !== "rparen") {
+                throw new EvalError(exports.EXPR_PARSE_ERROR, "missing closing ')'");
+            }
+            eat();
+            return inner;
+        }
+        if (t.t === "str") {
+            eat();
+            return { k: "str", v: t.v };
+        }
+        if (t.t === "ident") {
+            eat();
+            if (t.v === "null") {
+                // `null` is a reserved literal (the absent value), never an identifier
+                // or a callable name.
+                return { k: "null" };
+            }
+            if (peek()?.t === "lparen") {
+                eat();
+                const args = [];
+                if (peek()?.t !== "rparen") {
+                    args.push(parseOr());
+                    while (peek()?.t === "comma") {
+                        eat();
+                        args.push(parseOr());
+                    }
+                }
+                if (peek()?.t !== "rparen") {
+                    throw new EvalError(exports.EXPR_PARSE_ERROR, "missing closing ')' in call");
+                }
+                eat();
+                return { k: "call", name: t.v, args };
+            }
+            return { k: "ident", v: t.v };
+        }
+        throw new EvalError(exports.EXPR_PARSE_ERROR, "unexpected token");
+    }
+    const ast = parseOr();
+    if (pos !== tokens.length) {
+        throw new EvalError(exports.EXPR_PARSE_ERROR, "trailing tokens after expression");
+    }
+    return ast;
+}
+function asString(v) {
+    if (v === exports.NULL_VALUE) {
+        return "";
+    }
+    return typeof v === "string" ? v : String(v);
+}
+function asBoolean(v) {
+    if (typeof v === "boolean") {
+        return v;
+    }
+    throw new EvalError(exports.EXPR_PARSE_ERROR, "expected a boolean operand");
+}
+/** Evaluate the AST against `scope` + `port`; `&&` / `||` short-circuit so a skipped `featureFlag` is never read. */
+function evalAst(ast, scope, port) {
+    switch (ast.k) {
+        case "str":
+            return ast.v;
+        case "null":
+            return exports.NULL_VALUE;
+        case "ident": {
+            if (!(ast.v in scope)) {
+                throw new EvalError(exports.EXPR_UNDECLARED_IDENTIFIER, `identifier '${ast.v}' is not in scope`);
+            }
+            return scope[ast.v];
+        }
+        case "call": {
+            if (ast.name === "featureFlag") {
+                return port.flags(asString(evalAst(ast.args[0], scope, port)));
+            }
+            const fn = port.functions(ast.name);
+            if (!fn) {
+                throw new EvalError(exports.EXPR_NON_WHITELISTED_FUNCTION, `function '${ast.name}' is not in the whitelist`);
+            }
+            return fn(...ast.args.map((a) => asString(evalAst(a, scope, port))));
+        }
+        case "eq": {
+            const equal = evalAst(ast.left, scope, port) === evalAst(ast.right, scope, port);
+            return ast.neg ? !equal : equal;
+        }
+        case "and":
+            return (asBoolean(evalAst(ast.left, scope, port)) && asBoolean(evalAst(ast.right, scope, port)));
+        case "or":
+            return (asBoolean(evalAst(ast.left, scope, port)) || asBoolean(evalAst(ast.right, scope, port)));
+        case "not":
+            return !asBoolean(evalAst(ast.operand, scope, port));
+        default:
+            throw new EvalError(exports.EXPR_PARSE_ERROR, "unknown expression node");
+    }
+}
+//# sourceMappingURL=evaluateExpression.js.map

package/build/v4/expression/evaluateExpression.js.map

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

package/build/v4/index.d.ts

@@ -0,0 +1,41 @@
+/** Public surface of the v4 scaffolding world. */
+export * from "./engineVersion";
+export * from "./model/dataModel";
+export * from "./distribution/templateSource";
+export * from "./distribution/templateSourcePort";
+export * from "./distribution/templateArtifacts";
+export * from "./distribution/bundledFloor";
+export * from "./distribution/templateConfig";
+export * from "./distribution/templatePackage";
+export * from "./distribution/packageDir";
+export * from "./distribution/declarativePackage";
+export * from "./distribution/createSelector";
+export * from "./distribution/createQuestions";
+export * from "./inspection/scaffoldCatalog";
+export * from "./inspection/scaffoldMetadataSource";
+export * from "./expression/evaluateExpression";
+export * from "./renderContext/buildRenderContext";
+export * from "./collectInputs/collectInputs";
+export * from "./pipeline/runScaffoldPipeline";
+export * from "./validation/validateTemplatePackage";
+export * from "./validation/capabilityCatalog";
+export * from "./validation/templateArchiveValidation";
+export * from "./buildTarget/resolveBuildTarget";
+export * from "./buildTarget/parseSelector";
+export * from "./runtime/whitelist";
+export * from "./runtime/renderMustache";
+export * from "./runtime/steps/daAction";
+export * from "./runtime/steps/daSensitivity";
+export * from "./runtime/generalSensitivityLabel";
+export * from "./runtime/steps/mcpAuth";
+export * from "./runtime/packageParse";
+export * from "./runtime/inMemoryRuntime";
+export * from "./runtime/realRuntime";
+export * from "./runtime/scaffold";
+export * from "./runtime/scaffoldFromPackageDir";
+export * from "./surface/uiPromptUI";
+export * from "./surface/createInputs";
+export * from "./surface/createSelectorWalk";
+export * from "./surface/deriveCreateOptions";
+export * from "./surface/modifySelectorWalk";
+//# sourceMappingURL=index.d.ts.map

package/build/v4/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAElD,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC"}

package/build/v4/index.js

@@ -0,0 +1,46 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/** Public surface of the v4 scaffolding world. */
+tslib_1.__exportStar(require("./engineVersion"), exports);
+tslib_1.__exportStar(require("./model/dataModel"), exports);
+tslib_1.__exportStar(require("./distribution/templateSource"), exports);
+tslib_1.__exportStar(require("./distribution/templateSourcePort"), exports);
+tslib_1.__exportStar(require("./distribution/templateArtifacts"), exports);
+tslib_1.__exportStar(require("./distribution/bundledFloor"), exports);
+tslib_1.__exportStar(require("./distribution/templateConfig"), exports);
+tslib_1.__exportStar(require("./distribution/templatePackage"), exports);
+tslib_1.__exportStar(require("./distribution/packageDir"), exports);
+tslib_1.__exportStar(require("./distribution/declarativePackage"), exports);
+tslib_1.__exportStar(require("./distribution/createSelector"), exports);
+tslib_1.__exportStar(require("./distribution/createQuestions"), exports);
+tslib_1.__exportStar(require("./inspection/scaffoldCatalog"), exports);
+tslib_1.__exportStar(require("./inspection/scaffoldMetadataSource"), exports);
+tslib_1.__exportStar(require("./expression/evaluateExpression"), exports);
+tslib_1.__exportStar(require("./renderContext/buildRenderContext"), exports);
+tslib_1.__exportStar(require("./collectInputs/collectInputs"), exports);
+tslib_1.__exportStar(require("./pipeline/runScaffoldPipeline"), exports);
+tslib_1.__exportStar(require("./validation/validateTemplatePackage"), exports);
+tslib_1.__exportStar(require("./validation/capabilityCatalog"), exports);
+tslib_1.__exportStar(require("./validation/templateArchiveValidation"), exports);
+tslib_1.__exportStar(require("./buildTarget/resolveBuildTarget"), exports);
+tslib_1.__exportStar(require("./buildTarget/parseSelector"), exports);
+tslib_1.__exportStar(require("./runtime/whitelist"), exports);
+tslib_1.__exportStar(require("./runtime/renderMustache"), exports);
+tslib_1.__exportStar(require("./runtime/steps/daAction"), exports);
+tslib_1.__exportStar(require("./runtime/steps/daSensitivity"), exports);
+tslib_1.__exportStar(require("./runtime/generalSensitivityLabel"), exports);
+tslib_1.__exportStar(require("./runtime/steps/mcpAuth"), exports);
+tslib_1.__exportStar(require("./runtime/packageParse"), exports);
+tslib_1.__exportStar(require("./runtime/inMemoryRuntime"), exports);
+tslib_1.__exportStar(require("./runtime/realRuntime"), exports);
+tslib_1.__exportStar(require("./runtime/scaffold"), exports);
+tslib_1.__exportStar(require("./runtime/scaffoldFromPackageDir"), exports);
+tslib_1.__exportStar(require("./surface/uiPromptUI"), exports);
+tslib_1.__exportStar(require("./surface/createInputs"), exports);
+tslib_1.__exportStar(require("./surface/createSelectorWalk"), exports);
+tslib_1.__exportStar(require("./surface/deriveCreateOptions"), exports);
+tslib_1.__exportStar(require("./surface/modifySelectorWalk"), exports);
+//# sourceMappingURL=index.js.map

package/build/v4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;AAElC,kDAAkD;AAElD,0DAAgC;AAChC,4DAAkC;AAClC,wEAA8C;AAC9C,4EAAkD;AAClD,2EAAiD;AACjD,sEAA4C;AAC5C,wEAA8C;AAC9C,yEAA+C;AAC/C,oEAA0C;AAC1C,4EAAkD;AAClD,wEAA8C;AAC9C,yEAA+C;AAC/C,uEAA6C;AAC7C,8EAAoD;AACpD,0EAAgD;AAChD,6EAAmD;AACnD,wEAA8C;AAC9C,yEAA+C;AAC/C,+EAAqD;AACrD,yEAA+C;AAC/C,iFAAuD;AACvD,2EAAiD;AACjD,sEAA4C;AAC5C,8DAAoC;AACpC,mEAAyC;AACzC,mEAAyC;AACzC,wEAA8C;AAC9C,4EAAkD;AAClD,kEAAwC;AACxC,iEAAuC;AACvC,oEAA0C;AAC1C,gEAAsC;AACtC,6DAAmC;AACnC,2EAAiD;AACjD,+DAAqC;AACrC,iEAAuC;AACvC,uEAA6C;AAC7C,wEAA8C;AAC9C,uEAA6C"}

package/build/v4/inspection/scaffoldCatalog.d.ts

@@ -0,0 +1,28 @@
+import { FxError } from "@microsoft/teamsfx-api";
+import { Result } from "neverthrow";
+import { PresentationQuestion } from "../buildTarget/parseSelector";
+import { SelectorRoute } from "../buildTarget/resolveBuildTarget";
+import { QuestionSpec } from "../collectInputs/collectInputs";
+import { SelectorKind } from "../distribution/createSelector";
+/** Metadata input boundary shared by authored and staged catalog consumers. */
+export interface ScaffoldMetadataSource {
+    load(): Result<Buffer, FxError>;
+}
+/** One declarative template and every selector route that targets it. */
+export interface ScaffoldCatalogTemplate {
+    templateId: string;
+    routes: SelectorRoute[];
+    descriptor: unknown;
+    questions: QuestionSpec[];
+    pipeline: unknown;
+}
+/** Deterministic projection of one v4 selector and its routed package metadata. */
+export interface ScaffoldCatalog {
+    kind: SelectorKind;
+    questions: PresentationQuestion[];
+    templates: ScaffoldCatalogTemplate[];
+    externalRoutes: SelectorRoute[];
+}
+/** Inspect one metadata source without executing any declared scaffold behavior. */
+export declare function inspectScaffoldCatalog(source: ScaffoldMetadataSource, kind: SelectorKind): Result<ScaffoldCatalog, FxError>;
+//# sourceMappingURL=scaffoldCatalog.d.ts.map

package/build/v4/inspection/scaffoldCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffoldCatalog.d.ts","sourceRoot":"","sources":["../../../src/v4/inspection/scaffoldCatalog.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAA8B,MAAM,mCAAmC,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,EAGL,YAAY,EACb,MAAM,gCAAgC,CAAC;AAGxC,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAMD,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAuDlC"}

package/build/v4/inspection/scaffoldCatalog.js

@@ -0,0 +1,66 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspectScaffoldCatalog = inspectScaffoldCatalog;
+const neverthrow_1 = require("neverthrow");
+const resolveBuildTarget_1 = require("../buildTarget/resolveBuildTarget");
+const createSelector_1 = require("../distribution/createSelector");
+const declarativePackage_1 = require("../distribution/declarativePackage");
+function compareTemplateIds(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Inspect one metadata source without executing any declared scaffold behavior. */
+function inspectScaffoldCatalog(source, kind) {
+    const loaded = source.load();
+    if (loaded.isErr()) {
+        return (0, neverthrow_1.err)(loaded.error);
+    }
+    const selector = (0, createSelector_1.openSelector)(loaded.value, kind);
+    if (selector.isErr()) {
+        return (0, neverthrow_1.err)(selector.error);
+    }
+    const presentation = (0, createSelector_1.openSelectorPresentation)(loaded.value, kind);
+    if (presentation.isErr()) {
+        return (0, neverthrow_1.err)(presentation.error);
+    }
+    const routesByTemplate = new Map();
+    const externalRoutes = [];
+    for (const route of selector.value.routes) {
+        const routeShape = (0, resolveBuildTarget_1.validateSelectorRouteShape)(route);
+        if (routeShape.isErr()) {
+            return (0, neverthrow_1.err)(routeShape.error);
+        }
+        if (route.engine !== "v4") {
+            externalRoutes.push(route);
+            continue;
+        }
+        if (route.templateId !== undefined) {
+            const routes = routesByTemplate.get(route.templateId) ?? [];
+            routes.push(route);
+            routesByTemplate.set(route.templateId, routes);
+        }
+    }
+    const templates = [];
+    const templateIds = [...routesByTemplate.keys()].sort(compareTemplateIds);
+    for (const templateId of templateIds) {
+        const metadata = (0, declarativePackage_1.openDeclarativePackageMetadata)(loaded.value, { kind, templateId });
+        if (metadata.isErr()) {
+            return (0, neverthrow_1.err)(metadata.error);
+        }
+        templates.push({
+            templateId,
+            routes: routesByTemplate.get(templateId) ?? [],
+            descriptor: metadata.value.descriptor,
+            questions: metadata.value.questions,
+            pipeline: metadata.value.pipeline,
+        });
+    }
+    return (0, neverthrow_1.ok)({
+        kind,
+        questions: presentation.value.questions,
+        templates,
+        externalRoutes,
+    });
+}
+//# sourceMappingURL=scaffoldCatalog.js.map

package/build/v4/inspection/scaffoldCatalog.js.map

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

package/build/v4/inspection/scaffoldMetadataSource.d.ts

@@ -0,0 +1,6 @@
+import { ScaffoldMetadataSource } from "./scaffoldCatalog";
+/** Adapt immutable staged metadata archive bytes to the catalog source port. */
+export declare function metadataArchiveSource(bytes: Buffer): ScaffoldMetadataSource;
+/** Adapt the authored `templates/v4` directory to a metadata-only in-memory archive. */
+export declare function authoredDirectoryMetadataSource(root: string): ScaffoldMetadataSource;
+//# sourceMappingURL=scaffoldMetadataSource.d.ts.map

package/build/v4/inspection/scaffoldMetadataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffoldMetadataSource.d.ts","sourceRoot":"","sources":["../../../src/v4/inspection/scaffoldMetadataSource.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AA+C3D,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAE3E;AAED,wFAAwF;AACxF,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAiBpF"}