@sun-asterisk/sungen 3.2.34 → 3.3.0-alpha.1

package/dist/contract/project-contract-blockers.js

@@ -0,0 +1,73 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contractBlockers = contractBlockers;
+/**
+ * Which units' contracts hold a delivery back — for the Claude Code guard (OES-12.3, DOS-14.4).
+ *
+ * HEAD is read once (one `git ls-tree`, bounded by the caller's timeout). A unit with no lock in the
+ * working tree AND none in HEAD has no contract to break and is skipped without parsing anything.
+ * Every other unit gets its verdict rebuilt by buildContractVerdict — the same function `contract
+ * check` runs — and anything but `pass` blocks. A lock deleted from the working tree still counts
+ * while HEAD holds it. If git FAILS in a checkout that has .git while a delivered unit has a lock,
+ * this throws (GitUnavailableError): the guard asks rather than calling an unverifiable lock clean.
+ */
+const fs = __importStar(require("fs"));
+const build_contract_verdict_1 = require("./build-contract-verdict");
+const contract_git_1 = require("./contract-git");
+const contract_schema_1 = require("./contract-schema");
+const contracts_lock_file_1 = require("./contracts-lock-file");
+function contractBlockers(projectRoot, units, opts = {}) {
+    const unique = [...new Map(units.map((u) => [u.dir, u])).values()];
+    const snap = (0, contract_git_1.headSnapshot)(projectRoot, opts.gitTimeoutMs ?? contract_git_1.CLI_GIT_TIMEOUT_MS);
+    const hasWorkingLock = (u) => fs.existsSync((0, contracts_lock_file_1.lockPathFor)(u.dir));
+    if (snap.error && unique.some(hasWorkingLock))
+        throw new contract_git_1.GitUnavailableError(snap.error);
+    const out = [];
+    for (const unit of unique) {
+        if (!hasWorkingLock(unit) && !snap.blobs?.has((0, contract_git_1.posixRel)(projectRoot, (0, contracts_lock_file_1.lockPathFor)(unit.dir))))
+            continue;
+        const v = (0, build_contract_verdict_1.buildContractVerdict)(projectRoot, unit, { snapshot: snap });
+        if (v.verdict === 'pass')
+            continue;
+        const worst = v.scenarios.find((s) => contract_schema_1.HARD_CLASSES.has(s.class)) ?? v.scenarios.find((s) => s.class === 'hash-changed');
+        const headline = worst
+            ? `${worst.id} ${worst.class}${worst.findings[0] ? ` (${worst.findings[0].detail})` : ''}`
+            : `${v.uncommitted.length} lock entr${v.uncommitted.length === 1 ? 'y is' : 'ies are'} not what QA approved and committed (${v.uncommitted[0]?.id} ${v.uncommitted[0]?.change})`;
+        out.push({ unit: unit.name, verdict: v.verdict, headline });
+    }
+    return out;
+}
+//# sourceMappingURL=project-contract-blockers.js.map

package/dist/contract/project-contract-blockers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-contract-blockers.js","sourceRoot":"","sources":["../../src/contract/project-contract-blockers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,4CAiBC;AAnCD;;;;;;;;;GASG;AACH,uCAAyB;AACzB,qEAA4F;AAC5F,iDAAiG;AACjG,uDAAiD;AACjD,+DAAoD;AAIpD,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,KAAqB,EAAE,OAAkC,EAAE;IAC/G,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,IAAA,2BAAY,EAAC,WAAW,EAAE,IAAI,CAAC,YAAY,IAAI,iCAAkB,CAAC,CAAC;IAChF,MAAM,cAAc,GAAG,CAAC,CAAe,EAAW,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAA,iCAAW,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvF,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAAE,MAAM,IAAI,kCAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzF,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAA,uBAAQ,EAAC,WAAW,EAAE,IAAA,iCAAW,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QACtG,MAAM,CAAC,GAAG,IAAA,6CAAoB,EAAC,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,cAAc,CAAC,CAAC;QACxH,MAAM,QAAQ,GAAG,KAAK;YACpB,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1F,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,aAAa,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,wCAAwC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC;QACnL,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/contract/record-contract-approval.d.ts

@@ -0,0 +1,21 @@
+import { ContractLock, ContractScenario } from './contract-schema';
+export interface ApprovalWrite {
+    projectRoot: string;
+    unitDir: string;
+    unit: string;
+    approve: ContractScenario[];
+    removed: string[];
+    reason?: string;
+    lock: ContractLock | null;
+}
+export declare const DEFAULT_APPROVAL_REASON = "QA reviewed the normalized Gherkin contract";
+/** The decision scope of a unit directory (`screens/login`, `api/flows/pay`…). */
+export declare function scopeOfUnitDir(projectRoot: string, unitDir: string): string;
+export declare function nextLock(w: ApprovalWrite, decisionId: string, approvedAt: string): ContractLock;
+/** Throws LockSecretError when the lock this approval would write carries a sensitive value. */
+export declare function checkApprovalSecrets(w: ApprovalWrite): void;
+export declare function recordContractApproval(w: ApprovalWrite): {
+    decisionId: string;
+    lock: ContractLock;
+};
+//# sourceMappingURL=record-contract-approval.d.ts.map

package/dist/contract/record-contract-approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-contract-approval.d.ts","sourceRoot":"","sources":["../../src/contract/record-contract-approval.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAe,MAAM,mBAAmB,CAAC;AAIhF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED,eAAO,MAAM,uBAAuB,gDAAgD,CAAC;AAErF,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAK/F;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAiBnG"}

package/dist/contract/record-contract-approval.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_APPROVAL_REASON = void 0;
+exports.scopeOfUnitDir = scopeOfUnitDir;
+exports.nextLock = nextLock;
+exports.checkApprovalSecrets = checkApprovalSecrets;
+exports.recordContractApproval = recordContractApproval;
+/**
+ * What an approval writes, once a human has confirmed it (DOS-14.3, DOS-14.4, takumi T5):
+ *
+ *   1. the secret guard over the exact lock text — a hit writes nothing at all
+ *   2. a `contract-approval` decision listing every approved scenario id + hash (and the removals)
+ *   3. the lock: each approved entry `humanApproved: true`, `decisionId` = that decision, and
+ *      `approvedAt` = its `valid_from` — the pair `contract check` cross-checks (M1)
+ *
+ * The decision goes first: a crash between the two leaves a record without a lock entry, never an
+ * entry pointing at nothing. Only `sungen contract approve` calls this after its TTY confirmation;
+ * the confirmation itself lives there (approve-contract.ts).
+ */
+const path = __importStar(require("path"));
+const append_decision_1 = require("../decisions/append-decision");
+const decision_file_1 = require("../decisions/decision-file");
+const decision_source_1 = require("../decisions/decision-source");
+const contract_schema_1 = require("./contract-schema");
+const contracts_lock_file_1 = require("./contracts-lock-file");
+const lock_secret_guard_1 = require("./lock-secret-guard");
+exports.DEFAULT_APPROVAL_REASON = 'QA reviewed the normalized Gherkin contract';
+/** The decision scope of a unit directory (`screens/login`, `api/flows/pay`…). */
+function scopeOfUnitDir(projectRoot, unitDir) {
+    const scope = path.relative(path.join(projectRoot, 'qa'), unitDir).split(path.sep).join('/');
+    if (!(0, decision_file_1.isValidScope)(scope))
+        throw new Error(`${unitDir} is not a unit directory under qa/ (screens|flows|api/<unit>, api/flows/<flow>)`);
+    return scope;
+}
+function nextLock(w, decisionId, approvedAt) {
+    const scenarios = { ...(w.lock?.scenarios ?? {}) };
+    for (const id of w.removed)
+        delete scenarios[id];
+    for (const sc of w.approve)
+        scenarios[sc.id] = (0, contracts_lock_file_1.lockEntryFor)(sc, decisionId, approvedAt);
+    return { schema: contract_schema_1.LOCK_SCHEMA, scenarios };
+}
+/** Throws LockSecretError when the lock this approval would write carries a sensitive value. */
+function checkApprovalSecrets(w) {
+    (0, lock_secret_guard_1.assertNoLockSecrets)(w.approve, (0, contracts_lock_file_1.serializeLock)(nextLock(w, 'D-0000000000000000', new Date().toISOString())));
+}
+function recordContractApproval(w) {
+    const scope = scopeOfUnitDir(w.projectRoot, w.unitDir);
+    checkApprovalSecrets(w);
+    const payload = {
+        unit: w.unit,
+        scenarios: w.approve.map((s) => ({ id: s.id, hash: s.hash, implementation: s.implementation })),
+        removed: w.removed,
+    };
+    const decision = (0, append_decision_1.appendDecision)(w.projectRoot, scope, {
+        kind: 'contract-approval', anchors: [], visibility: 'internal', valid_from: new Date().toISOString(), payload,
+        text: `Approved the Test Contract of ${w.unit}: ${[...w.approve.map((s) => s.id), ...w.removed.map((id) => `-${id}`)].join(', ')}`,
+        reason: w.reason?.trim() || exports.DEFAULT_APPROVAL_REASON,
+        source: { by: (0, decision_source_1.gitUserName)(w.projectRoot), where: 'cli' },
+    });
+    const lock = nextLock(w, decision.entry.id, decision.entry.valid_from);
+    (0, contracts_lock_file_1.writeLockFile)((0, contracts_lock_file_1.lockPathFor)(w.unitDir), lock);
+    return { decisionId: decision.entry.id, lock };
+}
+//# sourceMappingURL=record-contract-approval.js.map

package/dist/contract/record-contract-approval.js.map

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

package/dist/contract/render-free-gherkin.d.ts

@@ -0,0 +1,40 @@
+import { TestDataIndex } from './data-normalize';
+import type { TargetFacts, TargetIdentity } from './trace/target-identity';
+import type { IntentStep } from './trace/trace-steps';
+export declare const CONTROL_CHARS: RegExp;
+export interface ResolvedTarget {
+    identity: TargetIdentity;
+    facts?: TargetFacts;
+}
+export interface RenderedStep {
+    keyword: 'Given' | 'When' | 'Then' | 'And';
+    sentence: string;
+    kind: 'action' | 'assert';
+    /** The outermost `test.step` title (impl:code compares group by group). */
+    group?: string;
+    low?: string;
+    opaque?: {
+        verbatim: string;
+        where?: string;
+    };
+}
+export interface RenderContext {
+    index: TestDataIndex;
+    projectRoot: string;
+    specFile?: string;
+    secrets: Set<string>;
+}
+export declare function renderTraceSteps(steps: IntentStep[], targets: Map<string, ResolvedTarget>, ctx: RenderContext): RenderedStep[];
+/** The Gherkin lines of one scenario's steps, with their comments. */
+export declare function stepLines(steps: RenderedStep[]): string[];
+export interface FreeScenarioBlock {
+    id: string;
+    title: string;
+    tags: string[];
+    comments: string[];
+    steps: RenderedStep[];
+}
+export declare function scenarioBlockText(b: FreeScenarioBlock): string;
+export declare const FREE_FEATURE_HEADER: string[];
+export declare function freeFeatureText(unit: string, blocks: string[]): string;
+//# sourceMappingURL=render-free-gherkin.d.ts.map

package/dist/contract/render-free-gherkin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-free-gherkin.d.ts","sourceRoot":"","sources":["../../src/contract/render-free-gherkin.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAsB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,aAAa,QAAuC,CAAC;AAElE,MAAM,WAAW,cAAc;IAAG,QAAQ,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE;AACjF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AACD,MAAM,WAAW,aAAa;IAAG,KAAK,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE;AAwBrH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,aAAa,GAAG,YAAY,EAAE,CA0B9H;AAED,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAQzD;AAED,MAAM,WAAW,iBAAiB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE;AAE3H,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAE9D;AAED,eAAO,MAAM,mBAAmB,UAI/B,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtE"}

package/dist/contract/render-free-gherkin.js

@@ -0,0 +1,141 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FREE_FEATURE_HEADER = exports.CONTROL_CHARS = void 0;
+exports.renderTraceSteps = renderTraceSteps;
+exports.stepLines = stepLines;
+exports.scenarioBlockText = scenarioBlockText;
+exports.freeFeatureText = freeFeatureText;
+/**
+ * A trace's intent steps → Gherkin steps, deterministically (DOS-14.8): the same trace and the same
+ * identities give the same text, byte for byte. No LLM is involved — naming a scenario or suggesting
+ * a VP-id is left to the user (or an agent) and never touches the steps or the hash.
+ *
+ *   keywords   first step `Given`; the next action `When`, later actions `And`; a check after an
+ *              action `Then`, after a check `And`; an action after a check `When`
+ *   drops      a click on an element immediately followed by a fill of the SAME element (a focus click)
+ *   opaque     `User see opaque check "<source line>"` / `User do opaque step "<GET /api/x>"`, with a
+ *              `# opaque at <file>:<line>` comment — kept verbatim, always reviewed by a human
+ *   low        `# identity low: <why>` above any step whose target is not proven
+ *   safety     secrets typed into credential fields are redacted everywhere; machine paths scrubbed
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const field_semantic_redaction_1 = require("./field-semantic-redaction");
+const data_normalize_1 = require("./data-normalize");
+const render_trace_target_1 = require("./render-trace-target");
+const render_trace_sentence_1 = require("./render-trace-sentence");
+const trace_identity_resolution_1 = require("./trace/trace-identity-resolution");
+exports.CONTROL_CHARS = /[\u0000-\u001f\u007f\u2028\u2029]/g;
+function whereOf(step, ctx) {
+    const loc = step.location;
+    if (!loc?.file)
+        return {};
+    const own = ctx.specFile && (loc.file === ctx.specFile || loc.file.endsWith(`/${ctx.specFile}`) || path.basename(loc.file) === path.basename(ctx.specFile));
+    const file = own ? ctx.specFile : (0, field_semantic_redaction_1.displayPath)(loc.file, ctx.projectRoot);
+    let line;
+    if (own) {
+        try {
+            line = fs.readFileSync(path.join(ctx.projectRoot, ctx.specFile), 'utf8').split(/\r?\n/)[loc.line - 1]?.trim();
+        }
+        catch {
+            line = undefined;
+        }
+    }
+    return { where: `${file}:${loc.line}`, line };
+}
+const quoteVerbatim = (s) => `"${(0, data_normalize_1.normalizeShownText)(s).replace(/"/g, "'").replace(/\s+/g, ' ').trim()}"`;
+function keywordFor(kind, prev) {
+    const last = prev[prev.length - 1];
+    if (!last)
+        return 'Given';
+    if (kind === 'assert')
+        return last.kind === 'assert' ? 'And' : 'Then';
+    if (last.kind === 'assert')
+        return 'When';
+    return prev.length === 1 && last.keyword === 'Given' ? 'When' : 'And';
+}
+function renderTraceSteps(steps, targets, ctx) {
+    const out = [];
+    steps.forEach((step, i) => {
+        const t = step.callId ? targets.get(step.callId) : undefined;
+        const next = steps[i + 1];
+        if (step.method === 'click' && next && (next.method === 'fill' || next.method === 'type') && (0, render_trace_target_1.sameTarget)(t?.identity, next.callId ? targets.get(next.callId)?.identity : undefined))
+            return;
+        const group = step.group[0];
+        if (step.kind === 'opaque-assert' || step.kind === 'opaque-action') {
+            const { where, line } = whereOf(step, ctx);
+            const verbatim = step.kind === 'opaque-action' && /^[A-Z]+ /.test(step.verbatim ?? '') ? step.verbatim : line || step.verbatim || step.method;
+            const kind = step.kind === 'opaque-assert' ? 'assert' : 'action';
+            const sentence = kind === 'assert' ? `User see opaque check ${quoteVerbatim(verbatim)}` : `User do opaque step ${quoteVerbatim(verbatim)}`;
+            out.push({ keyword: keywordFor(kind, out), sentence, kind, ...(group ? { group } : {}), opaque: { verbatim, ...(where ? { where } : {}) } });
+            return;
+        }
+        const target = (0, trace_identity_resolution_1.isPageLevel)(step) ? { text: '' } : (0, render_trace_target_1.renderTarget)(t?.identity, t?.facts, typeof step.params.selector === 'string' ? step.params.selector : undefined);
+        const kind = step.kind === 'assert' ? 'assert' : 'action';
+        const sentence = kind === 'assert' ? (0, render_trace_sentence_1.assertSentence)(step, target.text) : (0, render_trace_sentence_1.actionSentence)(step, target.text, ctx, (0, render_trace_sentence_1.sensitiveStep)(step, t?.facts, t?.identity.name));
+        out.push({ keyword: keywordFor(kind, out), sentence, kind, ...(group ? { group } : {}), ...(target.low ? { low: target.low } : {}) });
+    });
+    // Control characters (terminal escapes, BEL, line separators) would corrupt or spoof a Gherkin line.
+    const clean = (s) => (0, field_semantic_redaction_1.scrubMachinePaths)((0, field_semantic_redaction_1.scrubKnownSecrets)(s, ctx.secrets), ctx.projectRoot).replace(exports.CONTROL_CHARS, '');
+    return out.map((s) => ({
+        ...s, sentence: clean(s.sentence), ...(s.low ? { low: clean(s.low) } : {}),
+        ...(s.opaque ? { opaque: { verbatim: clean(s.opaque.verbatim), ...(s.opaque.where ? { where: clean(s.opaque.where) } : {}) } } : {}),
+    }));
+}
+/** The Gherkin lines of one scenario's steps, with their comments. */
+function stepLines(steps) {
+    const lines = [];
+    for (const s of steps) {
+        if (s.opaque)
+            lines.push(`    # opaque${s.opaque.where ? ` at ${s.opaque.where}` : ''} — compared by a human, never automatically`);
+        if (s.low)
+            lines.push(`    # identity low: ${s.low}`);
+        lines.push(`    ${s.keyword} ${s.sentence}`);
+    }
+    return lines;
+}
+function scenarioBlockText(b) {
+    return [`  ${b.tags.join(' ')}`, `  Scenario: ${b.title}`, ...b.comments.map((c) => `    # ${c}`), ...stepLines(b.steps)].join('\n');
+}
+exports.FREE_FEATURE_HEADER = [
+    '# Derived by `sungen contract derive` from Playwright traces — deterministic, no LLM.',
+    '# These steps are the contract; the Playwright test is the implementation. Each scenario stays a',
+    '# proposal (not counted by the audit) until QA approves it: sungen contract approve --screen <unit>',
+];
+function freeFeatureText(unit, blocks) {
+    return [...exports.FREE_FEATURE_HEADER.map((l) => l.replace('<unit>', unit)), `Feature: ${unit} (free tests)`, '', ...blocks.flatMap((b) => [b, ''])].join('\n');
+}
+//# sourceMappingURL=render-free-gherkin.js.map

package/dist/contract/render-free-gherkin.js.map

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

package/dist/contract/render-trace-sentence.d.ts

@@ -0,0 +1,20 @@
+/**
+ * One trace intent step → one sungen Gherkin sentence (without its keyword), in the documented
+ * forms the contract normalizer reads (DOS-14.1): `fill [T] field with {{v}}`, `see [T] heading
+ * with text "x"`, `see the url matches "re"`, `do not see [T] dialog`, `see [T] checkbox is checked`…
+ * A check outside that vocabulary still renders (verbatim expression words) and normalizes to the
+ * `unknown` matcher — which the ladder never calls `match` unless the sentence is identical.
+ */
+import { TestDataIndex } from './data-normalize';
+import { isSensitiveTarget } from './field-semantic-redaction';
+import type { IntentStep } from './trace/trace-steps';
+export interface SentenceContext {
+    index: TestDataIndex;
+    /** Raw values typed into credential fields — scrubbed from everything written. */
+    secrets: Set<string>;
+}
+export declare function actionSentence(step: IntentStep, target: string, ctx: SentenceContext, sensitive: boolean): string;
+export declare function assertSentence(step: IntentStep, target: string): string;
+/** The value typed into a credential field is sensitive even when the field's name is not. */
+export declare const sensitiveStep: (step: IntentStep, facts: Parameters<typeof isSensitiveTarget>[0], name?: string) => boolean;
+//# sourceMappingURL=render-trace-sentence.d.ts.map

package/dist/contract/render-trace-sentence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-trace-sentence.d.ts","sourceRoot":"","sources":["../../src/contract/render-trace-sentence.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAsC,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAY,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,kFAAkF;IAClF,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACtB;AAuBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAoBjH;AAaD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsBvE;AAED,8FAA8F;AAC9F,eAAO,MAAM,aAAa,GAAI,MAAM,UAAU,EAAE,OAAO,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,MAAM,KAAG,OAC1B,CAAC"}

package/dist/contract/render-trace-sentence.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sensitiveStep = void 0;
+exports.actionSentence = actionSentence;
+exports.assertSentence = assertSentence;
+/**
+ * One trace intent step → one sungen Gherkin sentence (without its keyword), in the documented
+ * forms the contract normalizer reads (DOS-14.1): `fill [T] field with {{v}}`, `see [T] heading
+ * with text "x"`, `see the url matches "re"`, `do not see [T] dialog`, `see [T] checkbox is checked`…
+ * A check outside that vocabulary still renders (verbatim expression words) and normalizes to the
+ * `unknown` matcher — which the ladder never calls `match` unless the sentence is identical.
+ */
+const data_normalize_1 = require("./data-normalize");
+const field_semantic_redaction_1 = require("./field-semantic-redaction");
+const str = (v) => (typeof v === 'string' ? v : v === undefined || v === null ? '' : String(v));
+const quote = (v) => `"${v.replace(/"/g, "'").replace(/\r?\n/g, '\\n')}"`;
+/** A value as the step writes it: a whole `{{ref}}` bare, anything else quoted. */
+function valueText(raw, ctx, sensitive) {
+    const ref = ctx.index.byValue.get(raw);
+    if (ref)
+        return `{{${ref}}}`;
+    if (sensitive) {
+        if (raw)
+            ctx.secrets.add(raw);
+        return field_semantic_redaction_1.REDACTED;
+    }
+    const v = (0, data_normalize_1.normalizeValue)(raw, ctx.index);
+    return /^\{\{[^}]+\}\}$/.test(v) ? v : quote(v);
+}
+function pathOf(url) {
+    try {
+        const u = new URL(url);
+        return /^https?:$/.test(u.protocol) ? `${u.pathname}${u.search}` : url;
+    }
+    catch {
+        return url;
+    }
+}
+function selectValues(params) {
+    const opts = Array.isArray(params.options) ? params.options : [];
+    return opts.map((o) => (o && typeof o === 'object' ? str(o.valueOrLabel ?? o.value ?? o.label ?? o.index) : str(o))).join(' | ');
+}
+function actionSentence(step, target, ctx, sensitive) {
+    const p = step.params;
+    switch (step.method) {
+        case 'goto': return `User is on [${pathOf((0, data_normalize_1.normalizeShownText)(str(p.url)))}] page`;
+        case 'fill': return `User fill ${target} with ${valueText(str(p.value), ctx, sensitive)}`;
+        case 'type': return `User fill ${target} with ${valueText(str(p.text), ctx, sensitive)}`;
+        case 'click':
+        case 'tap': return `User click ${target}`;
+        case 'dblclick': return `User double click ${target}`;
+        case 'check': return `User check ${target}`;
+        case 'uncheck': return `User uncheck ${target}`;
+        case 'hover': return `User hover ${target}`;
+        case 'selectOption': return `User select ${target} with ${valueText(selectValues(p), ctx, false)}`;
+        case 'press': return `User press ${quote(str(p.key))} on ${target}`;
+        case 'setInputFiles': {
+            const files = Array.isArray(p.payloads) ? p.payloads.map((x) => str(x?.name)) : Array.isArray(p.localPaths) ? p.localPaths.map((x) => str(x).split(/[\\/]/).pop() ?? '') : [];
+            return `User fill ${target.replace(/\] \S+/, '] uploader')} with ${quote(files.join(' | '))}`;
+        }
+        case 'keyboardPress': return `User press ${quote(str(p.key))} key`;
+        default: return `User type ${valueText(str(p.text), ctx, false)} on the keyboard`;
+    }
+}
+function expectedOf(p) {
+    const list = Array.isArray(p.expectedText) ? p.expectedText : [];
+    if (list.length && list.every((e) => typeof e?.regexSource === 'string'))
+        return { kind: 'regex', value: list.map((e) => str(e.regexSource)).join(' | ') };
+    if (list.length)
+        return { kind: 'text', value: list.map((e) => str(e.string ?? e.regexSource)).join(' | ') };
+    if (typeof p.expectedNumber === 'number')
+        return { kind: 'text', value: String(p.expectedNumber) };
+    return { kind: 'none', value: '' };
+}
+const STATES = { 'to.be.checked': 'checked', 'to.be.enabled': 'enabled', 'to.be.disabled': 'disabled', 'to.be.focused': 'focused', 'to.be.empty': 'empty', 'to.be.editable': 'editable', 'to.be.attached': 'attached' };
+function assertSentence(step, target) {
+    const p = step.params;
+    const expr = str(p.expression);
+    const not = p.isNot === true;
+    const e = expectedOf(p);
+    const shown = (v) => quote((0, data_normalize_1.normalizeShownText)(v));
+    if (expr === 'to.have.url' || expr === 'to.have.title') {
+        const subject = expr === 'to.have.url' ? 'url' : 'title';
+        return `User see the ${subject} ${e.kind === 'regex' ? (not ? 'does not match' : 'matches') : not ? 'is not' : 'is'} ${shown(e.value)}`;
+    }
+    if (expr === 'to.be.visible')
+        return not ? `User do not see ${target}` : `User see ${target}`;
+    if (expr === 'to.be.hidden')
+        return not ? `User see ${target}` : `User see ${target} is hidden`;
+    if (STATES[expr])
+        return `User see ${target} is ${not ? 'not ' : ''}${STATES[expr]}`;
+    if (expr === 'to.have.text' || expr === 'to.contain.text') {
+        if (e.kind === 'regex')
+            return `User see ${target} ${not ? 'does not match' : 'matches'} ${shown(e.value)}`;
+        if (expr === 'to.contain.text')
+            return `User see ${target} ${not ? 'does not contain' : 'contains'} ${shown(e.value)}`;
+        return `User see ${target} ${not ? 'does not have text' : 'with text'} ${shown(e.value)}`;
+    }
+    if (expr === 'to.have.value' || expr === 'to.have.values')
+        return `User see ${target} ${not ? 'does not have value' : 'has value'} ${shown(e.value)}`;
+    if (expr === 'to.have.count')
+        return `User see ${target} ${not ? 'does not have' : 'has'} ${shown(e.value)} items`;
+    const words = expr.replace(/^to\./, '').replace(/\./g, ' ').replace(/^have /, 'has ').replace(/^be /, 'is ');
+    return `User see ${target} ${not ? 'not ' : ''}${words}${e.kind === 'none' ? '' : ` ${shown(e.value)}`}`;
+}
+/** The value typed into a credential field is sensitive even when the field's name is not. */
+const sensitiveStep = (step, facts, name) => (step.method === 'fill' || step.method === 'type') && (0, field_semantic_redaction_1.isSensitiveTarget)(facts, name);
+exports.sensitiveStep = sensitiveStep;
+//# sourceMappingURL=render-trace-sentence.js.map

package/dist/contract/render-trace-sentence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-trace-sentence.js","sourceRoot":"","sources":["../../src/contract/render-trace-sentence.ts"],"names":[],"mappings":";;;AAsCA,wCAoBC;AAaD,wCAsBC;AA7FD;;;;;;GAMG;AACH,qDAAqF;AACrF,yEAAyE;AASzE,MAAM,GAAG,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACjH,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC;AAE1F,mFAAmF;AACnF,SAAS,SAAS,CAAC,GAAW,EAAE,GAAoB,EAAE,SAAkB;IACtE,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,GAAG;QAAE,OAAO,KAAK,GAAG,IAAI,CAAC;IAC7B,IAAI,SAAS,EAAE,CAAC;QAAC,IAAI,GAAG;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO,mCAAQ,CAAC;IAAC,CAAC;IAClE,MAAM,CAAC,GAAG,IAAA,+BAAc,EAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,MAAM,CAAC,GAAW;IACzB,IAAI,CAAC;QAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC;IAAC,CAAC;AAC/H,CAAC;AAED,SAAS,YAAY,CAAC,MAA+B;IACnD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAE,CAA6B,CAAC,YAAY,IAAK,CAA6B,CAAC,KAAK,IAAK,CAA6B,CAAC,KAAK,IAAK,CAA6B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvP,CAAC;AAED,SAAgB,cAAc,CAAC,IAAgB,EAAE,MAAc,EAAE,GAAoB,EAAE,SAAkB;IACvG,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,CAAC,OAAO,eAAe,MAAM,CAAC,IAAA,mCAAkB,EAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QAClF,KAAK,MAAM,CAAC,CAAC,OAAO,aAAa,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;QAC1F,KAAK,MAAM,CAAC,CAAC,OAAO,aAAa,MAAM,SAAS,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC;QACzF,KAAK,OAAO,CAAC;QAAC,KAAK,KAAK,CAAC,CAAC,OAAO,cAAc,MAAM,EAAE,CAAC;QACxD,KAAK,UAAU,CAAC,CAAC,OAAO,qBAAqB,MAAM,EAAE,CAAC;QACtD,KAAK,OAAO,CAAC,CAAC,OAAO,cAAc,MAAM,EAAE,CAAC;QAC5C,KAAK,SAAS,CAAC,CAAC,OAAO,gBAAgB,MAAM,EAAE,CAAC;QAChD,KAAK,OAAO,CAAC,CAAC,OAAO,cAAc,MAAM,EAAE,CAAC;QAC5C,KAAK,cAAc,CAAC,CAAC,OAAO,eAAe,MAAM,SAAS,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;QACnG,KAAK,OAAO,CAAC,CAAC,OAAO,cAAc,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC;QACpE,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAE,CAA6B,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3M,OAAO,aAAa,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChG,CAAC;QACD,KAAK,eAAe,CAAC,CAAC,OAAO,cAAc,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnE,OAAO,CAAC,CAAC,OAAO,aAAa,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,kBAAkB,CAAC;IACpF,CAAC;AACH,CAAC;AAGD,SAAS,UAAU,CAAC,CAA0B;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,YAA+C,CAAC,CAAC,CAAC,EAAE,CAAC;IACrG,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC3J,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7G,IAAI,OAAO,CAAC,CAAC,cAAc,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;IACnG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,MAAM,GAA2B,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC;AAEhP,SAAgB,cAAc,CAAC,IAAgB,EAAE,MAAc;IAC7D,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,KAAK,CAAC,IAAA,mCAAkB,EAAC,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,OAAO,gBAAgB,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1I,CAAC;IACD,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC;IAC9F,IAAI,IAAI,KAAK,cAAc;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC,YAAY,MAAM,YAAY,CAAC;IAChG,IAAI,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,YAAY,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACrF,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC1D,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5G,IAAI,IAAI,KAAK,iBAAiB;YAAE,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACvH,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5F,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,gBAAgB;QAAE,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IACtJ,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;IACnH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC7G,OAAO,YAAY,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AAC3G,CAAC;AAED,8FAA8F;AACvF,MAAM,aAAa,GAAG,CAAC,IAAgB,EAAE,KAA8C,EAAE,IAAa,EAAW,EAAE,CACxH,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAA,4CAAiB,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAD1E,QAAA,aAAa,iBAC6D"}

package/dist/contract/render-trace-target.d.ts

@@ -0,0 +1,14 @@
+import type { TargetFacts, TargetIdentity } from './trace/target-identity';
+export declare function safeRefText(text: string): string;
+export declare const elementType: (role: string) => string;
+/** The text a locator itself pins (`internal:text="Hi"`, `internal:label="Email"i`, a test id), if any. */
+export declare function refFromSelector(selector: string | undefined): string;
+export interface RenderedTarget {
+    text: string;
+    low?: string;
+}
+/** `[Name] type in [Scope] container`, and why it is low when it is. */
+export declare function renderTarget(identity: TargetIdentity | undefined, facts: TargetFacts | undefined, selector: string | undefined): RenderedTarget;
+/** Two identities name the same element (used to drop a focus click before a fill). */
+export declare const sameTarget: (a: TargetIdentity | undefined, b: TargetIdentity | undefined) => boolean;
+//# sourceMappingURL=render-trace-target.d.ts.map

package/dist/contract/render-trace-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-trace-target.d.ts","sourceRoot":"","sources":["../../src/contract/render-trace-target.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkB3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAiC,CAAC;AAE7E,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUpE;AAED,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AAE9D,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAW/I;AAED,uFAAuF;AACvF,eAAO,MAAM,UAAU,GAAI,GAAG,cAAc,GAAG,SAAS,EAAE,GAAG,cAAc,GAAG,SAAS,KAAG,OACmC,CAAC"}