@pristine-ts/cli 2.0.7 → 2.0.17

package/dist/types/utils/pristine-argv.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parses an argv array — typically `process.argv` — to locate the pristine bin and
+ * extract the user-typed arguments that follow it.
+ *
+ * Why scan rather than positional-index: argv shape is runtime-dependent. Node and Bun
+ * happen to put `[executable, scriptPath, ...userArgs]` today, but a different runtime
+ * (or a launcher that prepends flags before the script) can violate that. Locating the
+ * bin by name — an element whose basename (stripped of any extension like `.cjs` /
+ * `.js` / `.mjs`) is `pristine` — is robust across:
+ *
+ *   - global installs (`pristine repl` → argv contains `/usr/local/.../pristine.cjs`)
+ *   - local installs (`./node_modules/.bin/pristine`)
+ *   - `npx pristine`
+ *   - direct `node dist/bin/pristine.cjs`
+ *   - alternative runtimes that may shape argv differently
+ *   - the synthetic argv the REPL handler builds for each typed line
+ *
+ * Stateless after construction; instantiate per parse.
+ */
+export declare class PristineArgv {
+    private static readonly BIN_NAME;
+    /** The argv element identified as the pristine bin (empty when not found). */
+    readonly scriptPath: string;
+    /** Every argv element after the pristine bin, in order. */
+    readonly userArgs: readonly string[];
+    constructor(rawArgv: readonly unknown[]);
+    /**
+     * True when the argv was recognizable as a pristine invocation (the bin token was
+     * located). Mappers short-circuit `supportsMapping` on this.
+     */
+    get isValid(): boolean;
+    private static isPristineBin;
+}

package/dist/types/utils/terminal-key-decoder.d.ts

@@ -0,0 +1,28 @@
+import { TerminalKey } from "../interfaces/terminal-key.interface";
+/**
+ * Translates the raw bytes Node delivers from a raw-mode stdin into structured
+ * {@link TerminalKey}s. Pure and static so it can be unit-tested without a real TTY.
+ *
+ * A single `data` chunk can carry more than one keystroke (notably a paste, or fast
+ * typing), so this returns an array. Control and escape sequences are recognized as one
+ * key each; a run of printable characters is split into one `Character` key per character
+ * so callers (masked input, menus) can echo and handle them uniformly.
+ */
+export declare class TerminalKeyDecoder {
+    /**
+     * Decodes a raw stdin chunk into the keys it represents.
+     *
+     *   - A recognized control byte / escape sequence that spans the whole chunk → one key.
+     *   - An unrecognized escape sequence (starts with ESC) → a single `Other` key, rather
+     *     than splitting it into bogus printable characters.
+     *   - Anything else → one key per character, with non-printable control bytes mapped to
+     *     `Other` so they're ignored rather than echoed.
+     */
+    static decode(data: string): TerminalKey[];
+    /**
+     * Maps a single recognized control byte or escape sequence to its key, or `undefined`
+     * when the input isn't one we handle.
+     * @private
+     */
+    private static decodeControl;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pristine-ts/cli",
-  "version": "2.0.7",
+  "version": "2.0.17",
   "description": "",
   "module": "dist/lib/esm/cli.module.js",
   "main": "dist/lib/cjs/cli.module.js",
@@ -20,20 +20,24 @@
   ],
   "author": "",
   "license": "ISC",
+  "engines": {
+    "node": ">=22.18.0"
+  },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@inquirer/prompts": "^7.2.0",
-    "@pristine-ts/common": "^2.0.7",
-    "@pristine-ts/core": "^2.0.7",
-    "@pristine-ts/data-mapping": "^2.0.7",
-    "@pristine-ts/data-mapping-common": "^2.0.7",
-    "@pristine-ts/file": "^2.0.7",
-    "@pristine-ts/logging": "^2.0.7",
-    "@pristine-ts/validation": "^2.0.7",
-    "jiti": "^2.4.0",
-    "uuid": "^9.0.1"
+    "@pristine-ts/common": "^2.0.17",
+    "@pristine-ts/configuration": "^2.0.17",
+    "@pristine-ts/core": "^2.0.17",
+    "@pristine-ts/data-mapping": "^2.0.17",
+    "@pristine-ts/data-mapping-common": "^2.0.17",
+    "@pristine-ts/file": "^2.0.17",
+    "@pristine-ts/logging": "^2.0.17",
+    "@pristine-ts/metadata": "^1.0.16",
+    "@pristine-ts/observability": "^2.0.17",
+    "@pristine-ts/telemetry": "^2.0.17",
+    "@pristine-ts/validation": "^2.0.17"
   },
   "devDependencies": {
     "esbuild": "^0.24.0"
@@ -72,7 +76,7 @@
       "src/*.{js,ts}"
     ]
   },
-  "gitHead": "8788c711f72b7ebdcec76bc8f6a56d51af143087",
+  "gitHead": "26201327def8a2705293e1e47ea12fa3dc438f53",
   "repository": {
     "type": "git",
     "url": "https://github.com/magieno/pristine-ts.git",