@sun-asterisk/sungen 3.2.26 → 3.2.28

package/src/utils/ref-key.ts

@@ -0,0 +1,43 @@
+/**
+ * ONE vocabulary for what a `[Reference]` means.
+ *
+ * The compiler's documented key rule is "the lowercase of the `[Reference]` text, spaces
+ * preserved" (`SelectorResolver.generateKey`). The harness re-implemented that rule with its own
+ * regex — `/\[([a-z0-9_.-]+):/` — which has no space in it, so a multi-word screen such as
+ * `[Basic Info:Email]` compiled, ran and passed, and was NEVER seen by `touchesOutcome`,
+ * `reachesOutcome`, phase coverage, handoffs or the navigation-target check. A real project
+ * hyphenated every namespace with zero functional change and its audit went 6.9 → 8.9 (#660).
+ *
+ * Two rules, one place:
+ *  - `normalizeRefLabel` IS the compiler's key rule. The compiler delegates here.
+ *  - `screenKey` is the COMPARISON form the harness uses for a screen/namespace: separators are
+ *    equivalent (`basic info` ≡ `basic-info` ≡ `basic_info`), because a contract author writes
+ *    `outcome.screen: basic-info` as readily as the feature writes `[Basic Info:…]`, and the
+ *    harness only ever asks "is this the same screen?" — never "which YAML key resolves?".
+ */
+
+/** The compiler's selector-key rule: NFC, lowercase, trimmed, inner whitespace collapsed. */
+export function normalizeRefLabel(label: string): string {
+  return label.normalize('NFC').toLowerCase().trim().replace(/\s+/g, ' ');
+}
+
+/** Comparison form for a screen / namespace name — separator-insensitive. */
+export function screenKey(label: string): string {
+  return normalizeRefLabel(label).replace(/[\s_-]+/g, ' ').trim();
+}
+
+/**
+ * Every namespace a piece of step text references, in order, as `screenKey`s.
+ * `[Screen:Element]` → `screen`; a bare `[Screen]` page reference is included too when `bare`
+ * is set (a `see [Done] page` assertion names the screen without an element).
+ */
+export function refNamespaces(text: string, opts: { bare?: boolean } = {}): string[] {
+  const out: string[] = [];
+  for (const m of text.matchAll(/\[([^\]]+)\]/g)) {
+    const inner = m[1];
+    const colon = inner.indexOf(':');
+    if (colon !== -1) out.push(screenKey(inner.slice(0, colon)));
+    else if (opts.bare) out.push(screenKey(inner));
+  }
+  return out;
+}