swipium 1.4.0 → 2.0.0

package/dist/automationGen/identifiers.js

@@ -0,0 +1,224 @@
+// Identifier safety for the generated JS/TS and Python suites (H4). Recorded element/page names
+// come from arbitrary app copy ("Continue", "Return", "2FA code", "class", "登录"), so every name
+// that becomes a class, field, attribute or method in generated source is sanitized here:
+//   - Latin diacritics transliterated first (asciiFold: "Configuración" > "Configuracion"), then
+//     remaining non-ASCII / punctuation stripped; empty > a stable fallback (element, element2, …);
+//   - a leading digit gets a prefix (2FACode > el2FACode / el_2fa_code);
+//   - language keywords / reserved words get a trailing underscore (continue > continue_);
+//   - names that would shadow a BaseScreen member (tap, find, driver, …) are suffixed too;
+//   - collisions are deduped deterministically in declaration order (name, name2, name3, …).
+// Pure, no I/O.
+/** Thrown when a recorded step cannot be expressed as real generated code. Generation fails with
+ *  this message instead of emitting a silent no-op (driver.swipe(0,0,0,0) / pass / a comment). */
+export class UnemittableStepError extends Error {
+    code = 'UNEMITTABLE_STEP';
+    constructor(message) {
+        super(message);
+        this.name = 'UnemittableStepError';
+    }
+}
+/** ECMAScript reserved words + strict-mode / TypeScript-sensitive words. */
+export const JS_RESERVED = new Set([
+    'break',
+    'case',
+    'catch',
+    'class',
+    'const',
+    'continue',
+    'debugger',
+    'default',
+    'delete',
+    'do',
+    'else',
+    'enum',
+    'export',
+    'extends',
+    'false',
+    'finally',
+    'for',
+    'function',
+    'if',
+    'import',
+    'in',
+    'instanceof',
+    'new',
+    'null',
+    'return',
+    'super',
+    'switch',
+    'this',
+    'throw',
+    'true',
+    'try',
+    'typeof',
+    'var',
+    'void',
+    'while',
+    'with',
+    'yield',
+    'let',
+    'static',
+    'implements',
+    'interface',
+    'package',
+    'private',
+    'protected',
+    'public',
+    'await',
+    'arguments',
+    'eval',
+    'undefined',
+    'NaN',
+    'Infinity',
+]);
+/** Python hard keywords (keyword.kwlist). Soft keywords (match/case/type/_) are valid identifiers. */
+export const PY_KEYWORDS = new Set([
+    'False',
+    'None',
+    'True',
+    'and',
+    'as',
+    'assert',
+    'async',
+    'await',
+    'break',
+    'class',
+    'continue',
+    'def',
+    'del',
+    'elif',
+    'else',
+    'except',
+    'finally',
+    'for',
+    'from',
+    'global',
+    'if',
+    'import',
+    'in',
+    'is',
+    'lambda',
+    'nonlocal',
+    'not',
+    'or',
+    'pass',
+    'raise',
+    'return',
+    'try',
+    'while',
+    'with',
+    'yield',
+]);
+/** Transliterate to ASCII where Unicode allows it: NFKD, then drop combining marks
+ *  ("Configuración" > "Configuracion", "Überblick" > "Uberblick", "file" > "file"). Scripts with no
+ *  ASCII decomposition ("登录") pass through unchanged and are stripped by the sanitizers. Applied
+ *  before EVERY class / module / file / member name derivation so they stay consistent
+ *  (without it "ó" became a word break: configuraci_nscreen.py next to configuraci_n2_screen.py). */
+export function asciiFold(s) {
+    return s.normalize('NFKD').replace(/\p{M}+/gu, '');
+}
+function words(s) {
+    return asciiFold(s)
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[^A-Za-z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+}
+/** PascalCase from arbitrary text (ASCII letters/digits only); '' when nothing survives. */
+export function pascalWords(s) {
+    return asciiFold(s)
+        .replace(/[^A-Za-z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((p) => p[0].toUpperCase() + p.slice(1))
+        .join('');
+}
+/** snake_case from arbitrary text (ASCII letters/digits only); '' when nothing survives. */
+export function snakeWords(s) {
+    return words(s).join('_').toLowerCase();
+}
+/** Deterministic de-duplicating allocator: first come keeps the base, later ones get 2, 3, …
+ *  A name that clashes with a RESERVED member (e.g. BaseScreen.tap) is suffixed with `_` first
+ *  (tap > tap_), matching the keyword convention; only then numbered. */
+export class NameAllocator {
+    normalize;
+    used;
+    reserved;
+    constructor(reserved = [], normalize = (s) => s) {
+        this.normalize = normalize;
+        this.reserved = new Set([...reserved].map(normalize));
+        this.used = new Set(this.reserved);
+    }
+    alloc(base, sep = '') {
+        const root = this.reserved.has(this.normalize(base)) ? `${base}_` : base;
+        let name = root;
+        let n = 2;
+        while (this.used.has(this.normalize(name)))
+            name = `${root}${sep}${n++}`;
+        this.used.add(this.normalize(name));
+        return name;
+    }
+}
+/** A camelCase JS identifier (field / variable). */
+export function jsMemberName(raw, fallback = 'element') {
+    const p = pascalWords(raw);
+    let id = p ? p[0].toLowerCase() + p.slice(1) : fallback;
+    if (/^[0-9]/.test(id))
+        id = `el${id}`;
+    if (JS_RESERVED.has(id))
+        id = `${id}_`;
+    return id;
+}
+/** A PascalCase JS/Python class name. */
+export function className(raw, fallback = 'Screen') {
+    let id = pascalWords(raw) || fallback;
+    if (/^[0-9]/.test(id))
+        id = `Screen${id}`;
+    if (JS_RESERVED.has(id) || PY_KEYWORDS.has(id))
+        id = `${id}_`;
+    return id;
+}
+/** A snake_case Python identifier (attribute / module / variable). */
+export function pyName(raw, fallback = 'element') {
+    let id = snakeWords(raw) || fallback;
+    if (/^[0-9]/.test(id))
+        id = `el_${id}`;
+    if (PY_KEYWORDS.has(id))
+        id = `${id}_`;
+    return id;
+}
+/** True for a plain JS identifier usable after a dot / as a bare object key. */
+export function isJsIdentifier(s) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(s);
+}
+/** Collapse text onto one line so it is safe inside a `//` or `#` line comment. */
+export function commentSafe(s) {
+    return (s ?? '').replace(/[\r\n\u2028\u2029]+/g, ' ');
+}
+export const DIRECTIONS = ['up', 'down', 'left', 'right'];
+export function checkDirection(dir, what) {
+    const d = (dir ?? '').toLowerCase();
+    if (DIRECTIONS.includes(d))
+        return d;
+    throw new UnemittableStepError(`cannot emit ${what}: direction ${JSON.stringify(dir)} is not one of up/down/left/right. Fix the recorded step and regenerate`);
+}
+export const SUPPORTED_KEYS = ['back', 'home', 'enter'];
+export function checkKey(key) {
+    const k = (key ?? 'back').toLowerCase();
+    if (SUPPORTED_KEYS.includes(k))
+        return k;
+    throw new UnemittableStepError(`cannot emit press step: key ${JSON.stringify(key)} is not supported by the generated suite (supported: ${SUPPORTED_KEYS.join(', ')})`);
+}
+/** Screens referenced by steps but absent from model.screens still need (empty) classes, or the
+ *  generated test would import a module that does not exist. */
+export function screensOf(model) {
+    const out = [...model.screens];
+    for (const s of model.steps) {
+        if (!out.some((sc) => sc.className === s.screen))
+            out.push({ className: s.screen, pageName: s.screen, elements: [] });
+    }
+    return out;
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/automationGen/identifiers.js.map

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